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0 Introduction
The Graphical Kernel System (GKS) provides a set of functions for computer graphics programming. GKS is a basic graphics system that can be used by the majority of applications that produce computer generated pictures. The main reasons for standardizing basic computer graphics are: a) to allow application programs involving graphics to be easily portable between different installations; b) to aid the understanding and use of graphics methods by application programmers; c) to serve manufacturers of graphics equipment as a guideline in providing useful combinations ics capabilities in a device. In order to reach these main objectives, the GKS design was based on the following requirements: d) GKS should include all the capabilities that are essential for the whole spectrum of graphics, from simple passive output to highly interactive applications. e) The whole range of graphics devices, including vector and raster devices, microfilm recorders, storage tube displays, refresh displays and colour displays should be controllable by GKS in a uniform way. fl GKS should provide all the capabilities required by a majority of applications without becoming unduly large. These requirements were used to formulate a number of principles that were used to judge ,specific design alternatives. Thus it was possible to contribute to the overall design goals while focussing on certain aspects. Five design aspects were identified, each having a group of principles g) Design goals: The following principles should not be violated by any technical design: 1) consistency: the mandatory requirements of GKS should not be mutually contradictory; 2) compatibility: other standards or commonly accepted rules of practice should not be violated; 3) orthogonality: the functions or modules of GKS should be independent of each other, or the dependency should be structured and well defined. h) Functional capabilities: The following principles were used to define the extent of GKS: 1) completeness: all functions that a` majority of applications tionality should be included; want to use on a given level of funcshould of graph-

2) minimality: functions that are unnecessary for applications of a given level of functionality not be provided;

3) compactness: an application should be able to achieve a desired result by a kt of functions and parameters that is as small as possible;
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4) richness: a rich set of functions offers an extensive range of facilities that stretches beyond the basic functions and includes higher order capabilities. It is obvious that there is a trade off between the principles in this group. Therefore, the functions of GKS are organized in nine levels. An implementation of GKS provides precisely the functions of one of these levels. While the lowest level contains only a minimal set of functions, higher levels are allowed to extend beyond the basic needs towards greater richness. i) User interface design: The following principles were used to define the user interface design: 1) user friendliness: GKS should allow the design of a desirable user interface; 2) clarity: the concepts and functional capabilities of GKS should be easily understandable, by the application programmer; especially

3) error handling: failure of system functions or modules, caused by errors of the system itself or by the application program, should be treated in such a way that the error reaction is clearly understandable and informative to the application programmer and that the impact on the system and the application program is as small as possible. Clarity and sound error handling are essential parts of user friendliness. Error handling is an integral part of GKS. To aid clarity, the system and its state can be presented to the user in an easily comprehensible manner. Clarity applies not only to the system design but also to the system description. To this end, the GKS specification is divided into a general description, a description of the underlying logical data structures represeznti.ng the state of the system, and a description of the functions and their effects on these data structures. j) Graphics devices: The following principles are associated with the range of graphics devices that can be addressed by GKS: 1) device independence: GKS functions should be designed to allow an application program, using these functions, to address facilities of quite different graphics output and input devices without modification of the program structure; 2) device richness: the full capabilities of a wide range of different graphics output and input devices should be accessible from the functions of GKS. These principles led to a fundamental concept underlying the GKS architecture: the concept of multiple independent graphical workstations connected to and driven by GKS. The application program can inquire the capabilities of every workstation. The GKS design includes escape functions that are easily identifiable within an application program and can be used to access special facilities of a particular'device. k) Implementation: The last group of principles is related to the implementation of GKS: 1) implementability: it should be possible to support the GKS functions in most host languages, on most operating systems and with most graphics devices; 2) language independence: it should be possible to access the standard facilities of GKS from all IS0 standard programm&g languages; 3) efficiency: GKS should be capable of being implemented without time consuming algorithms; 4j robustness: the operator and application programmer from hardware or software failure of the system. should be protected in the best possible way

The five groups of principles are interconnected. For example, design goals and functional capabilities both contribute'to user friendliness. Efficiency is also important when considering response time in an interactive environment. Some principles may be conflicting, such as richness versus minimality, comprehensive error handling versus efficiency, and compactness versus device richness. Compromises needed to be made to achieve the overall design objective: GKS should have an easily comprehensible structure and a set of functions that enables a vast majority of computer graphics users to design portable, device independent application programS addressing the whole range of computer graphics equipment. 9
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1 Scope and field of application

This International Standard qecifies a set of functions for computer graphics programming, the Graphical Kernel System (GKS). GKS is a basr; graphics system for applications that produce computer generated two dimensional pictures on line graphics or raster graph.& output devices. It supports operator input and interaction by supplying basic functions for graphical input and picture segmentation. It al!aws storage aud dynamic modification of pictures. A fundamental concept in GKS is the workstation, consisting of a number of input devices and a single output device. Several workstations can be used simultaneously. The applicatioil program is allowed to adapt its behaviom at a workstation to make best use of workstation capabilities. This Internation& Standard includes functions for storage on and retrieval from an external graphics file. Last bu: not least, the functions are organized in upward compatible levels with increasing capabilities.
NOTE - Fur certain parameters of the functions, CKS defines value ranges procedures. as heirlg rtserved for registration (ses 4 1.2). The meanings

of' these values will be defined using the estabkshed

GKS defines a language independent nucleus of a graphics system. For integration into a programming language, GKS is embedded in a language dependent layer obeying the particular conventions of that language. Annexes C to G are given for information; they do not form part of the specification.

3
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2 References

IS0 646, Information processi!g - IS0 7-bit coded character set for information interchange. IS0 2022, Information processing - IS0 ?-bit and b-bit coded character sets - Code extension techniques. IS0 2382113, Data processing - Vocabulary - Part 13: Computer graphics. IS0 6093, Information processing - Representation of numerical values in character strings for information interchange. `) IS0 8632, Information processing systems - Computer Graphics - Metafile for transfer and storage of picture description information - Part I : Functional description.`) - Part 2 : Character encoding.`) - Part 3 : Binary encoding.`) - Part 4 : Clear text encoding.`)

-1) At present at the stage of draft.

4
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3

Definitions

This clause

gives the

definition of the important terms of the Graphical Kernel Sysym (GKS).

NOTE - As far as possible, commonly accepted graphics terminology is used.

3.1 acknowledgement: Output to the operator of a logical input device indicating that a trigger has fired. 3.2 aspect ratio: A ratio of x to y used to describe the shape of a rectangle in a particular coordinate (for example, of a workstation window or a workstation viewport). system

3.3 aspects of primitives: Ways in which the appearance of a primitive can vary. Some aspects are controlled directly by primitive attributes, some are controlled indirectly through a bundle table. Primitives inside segments have an aspect controlled through the segment containing them, for example highlighting; primitives outside segments do not. 3.4 attribute: A particular property that applies to a display element (output primitive) or a segment. Examples: highlighting, character height. In GKS, some properties of workstations are called workstation attributes. . 3.5 baseline: A horizontal line within a character body (see figure 3) which, for many character definitions, has the appearance of being a lower limit OF the character shape. A descender passes below this line. All baselines in a font are in the same position in the character bodies. 3.6 bundle index: An index into a bundle table for a particular output primitive. dependent aspects of the primitive. It defines the w&station

3.7 bundle table: A workstation dependent table associated with a particular output primitive. Entries in the table specify all the workstation dependent aspects of a primitive. In GKS, bundle tables exist for the following output primitives: polyline, polymarker, text and fill area. 3.8 capline: A horizontal line within a character body (see figure 3) which, for many character definitions, has the appearance of being the upper limit of the character shape. An ascender may pass above this line and in some languages an additional mark (for example an accent) over the character may be defined above this line. All caplines in a font are in the same position in the character bodies. 3.9 cell array: A GKS output primitive consisting of a rectangular grid of equal size rectangular cells, each having a single colour.
NOTE - These ceils do not necessarily map one-to-one with pixels.

3.10 centreline: A vertical line bisecting the character body (see figure 3). 3.11 character body: A rectangle used by a font designer to dehne a character shape (see figure 3). All character bodies in a font have the same height. 3.12 choice device: A GKS logical input device providing a non-negative integer defining one of a set of alter. natives.

3.13 clipping: Removing parts of display elements that lie outside a given boundary, viewport.

usually a window or

3.14 colour table: A workstation dependent table, in which the entries specify the values of the red, green and blue intensities defining a particular colour. 3.15 coordinate graphics; Line graphics: Computer graphics in which display images are generated from display commands and coordinate data. 3.16 devi:e coordinate (DC): A coordinate expressed in a coordinate system that is device dependent. In GKS, DC units are me&s on a device capable of producing a precisely scaled image and appropriate workstation dependent units otherwise. 3.17 device driver: The device depeqdent part of a GKS implementation intended to support a graphics device. The device driver generates device dependent output and handles device dependent interaction. 3.18 device space: The space defined by the addressable points of a display device. . 3.19 display device; graphics device: A device (for example refresh display, storage tube display, plotter) on which `display image&an be represented.
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Definitions 3.20 display image; picture: A collection one time on a display surface. of output primitives or segments that are represented to the area available together at any

3.21 display space: (1) That portion of the devjce space corresponding images. (1) The working space of an input device such as a digitiser. 3.22 display surface; view surface: In a display 3.23 echo: The immediate display console. notification device. that medium value provided

for displaying

on which display

images may appear. at the for

of the current

by an input device to the operator features,

3.24 escape: A function in GKS used to access implementation or device dependent the generation of graphical output. that are not otherwise addressed by GKS. 3.25 feedback: Output value. indicating to the operator the application program's (closed

other than

interpretation

of a logical

input or

3.26 fill area: A GKS output primitive consisting of a polygon may be filled with a uniform colour, a pattern, or a hatch style.

boundary)

which may be hollow dependent consisting

3.27 fill area bundle'table: A table associating specific values for all workstation area primitive with a fill area bundle index. In GKS, this table contains entries style index, and colour index. 3.28 Generalized Drawing Primitive (GDP): An output tion capabilities such as curve drawing. primitive used to address

aspects of a fill of interior style, workstacapabili-

special geometrical

3.29 GKS level: Two values in the range 0 to 2 and a to c which together define a set of functional ties of GKS. An implementation of GKS provides precisely the functions of one level.

3.30 GKS Metafile (GKSM): A sequential file that can be written or read by GKS and is used for long-term storage (and for transmittal and transferral) of graphical information. 3.31 hallline: A horizontal line between the capline and the baseline within the character body (see figure 3), about which a horizontal string of characters in a font would appear centrally placed in the vertical direction. All halflines in a font are in the same position in the character bodies. 3.32 hatch: One possible method rior is filled with an arrangement of filling the interior of a polygon specified by a fill area primitive. of one or more sets of parallel lines. way of emphasizing a segment by modifying a property The inteFor

3.33 highlighting: A device independent example. blinking.

its visual attributes.

3.34 implementation mandatory: Implementation mandatory describes ized identically on all workstation 3 ;>f all implementations of GKS.

that is required

to be realIn GKS,

3.35 input class: A set of input devices that are logically equivalent pith respect to their function. the input classes are: LOCATOR. STROKE. VALUATOR, CHOICE, PICK and STRING.

3.36 inquiry function: A GKS function whose Furpose is to return values depending on the current state of There is no effect on the state of GKS or on GKS or on some fixed property of the GKS implementation. the display image. , 3.37 locator device: A GKS logical tion transformation humber. input device providing a position in world coordinates and a normaliza-

3.38 logical input device: A logical input device is an abstraction of one or more physical devices that delivers logical input values to the program. Logical input devices in GKS can be of type LOCATOR, STROKE, VALUATOR, CHOICE. PICK and STRING. 3.39 logical input value: A value delivered by a logical input device. which is used to identify a particular location.

3.40 marker: A glyph with a specified appearance

3.41 measure: A value (associated with a logical input device), which is determined by one or more physical ' input devices and a mapping from the values delivered by the physical devices. The logical input value delivered by a logical input device is the current value of the measure. 3.42 MI: An abbreviation 3.43 MO: An :tbhre\iation for GKS metafile input, a category of workstation. of workstation. *

for GKS metafi!e output.

a category

3.44 normalization transformation; viewing transformation; window-to-viewport transformation: A transformation that maps the boundary and interior of a window to the boundary and interior of a ljiewport. In GKS. 6
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this transformation

maps positions

in world coordinates

to normalized

device coordinates.

3.45 normalized device coordinates (NDC): A coordinate specified in a device independent intermediate coordistate the coordinate system, normalized to some range, typically 0 to 1. In GKS, during an intermediate nates may lie outside the defined range, but associated clipping information ensures that the o'utput does not exceed the coordinate range [O.I] x [0, I]. 3.46 operator: Person manipulating physical ices and cause their triggers to fire. input devices so as to change-the measures of logical inpur dev-

3.47 output primitive; graphic primitive; display element: A basic graphic element that can be used to consfruct a display image. Output primitives in GKS are polyline. polymarker. text, fill area. cell array. and generalized drawing primitive. 3.48 pick device: A GKS logical input device providing the associated segment name. the pick identifier attached to an output primitive and

3.49 pick identifier: A name, attached to individual output primitives within ;I segment, pick device. The same pick identifier can be assigned to different output primitives. 3.50 pixel; picture element: The smallest colour or intensity. 3.51 polyline: A GKS output primitive element consisting of a display surface

and returned

by the a

that can be independently -li~_es.

assigned

of a set of connected

3.52 polyline bundle table: A table associating specific values for all workstation dependent aspects of a polyIn GKS, this table contains entries consisting of linetype, line primitive with a polyline bundle index. linewidth.scal'e factor. and colour index. 3.53 polymarker: A GKS outpu\ primitive consisting of a set of locations, each to be indicated by a marker. aspects of a consisting of in a

3.54 polymarker bundle table: A table associating specific values for all workstation dependent In GKS. this table contains entries polymarker primitive with a polymarker bundle index. marker type, marker size scale factor, and colour index. 3.55 primitive attribute: Primitive workstation independent manner, 3.56 prompt: Output attribute values (for output primitives) are selected but can have workstation dependent effects. indicating

by the application

to the operator

that a specific logical input device is available. image is composed an axis. In GKS, of an array of pixels arranged is restricted to of

3.57 raster graphics: Computer in rows and columns. 3.58 rotation: Turning segments.

graphics

in which a display image about

all or part of a display

this capability

3.59 scaling; zooming: Enlarging or rc~!!?~.?; ail or part 01' a display image by multiplying display elements by a constant value. In GKS, this capability is restricted to segments.
NOTE - For diKerent scaling in two orthogonal directions two constant values are required.

the coordinates

3.60 segment: A collection

of display elements

that can be manipulated

as a unit. segment attributes are visibility, takes preto

3.61 segment attributes: Attributes highlighting, detectability, segment

In bKS, that apply only to segments. priority, and segment transformation. used to determine

3.62 segment priority: A segment attribute cedence for graphic output and input. 3.63 segment transformation: appear with varying position

which of several overlapping elements (rotation)

segments

A transformation that causes the display (translation). size (scale), and/or orientation a character

defined by a segment on the display surface.

3.64 string device: A GKS logical input device providing 3.65 stroke device: A GKS logical input normalization transformation number. 3.66 text: A GKS output primitive device providing

string as its result. of points in world coordinates. and a

a sequence string.

consisting

of a character

3.67 text bundle table: A table associating specific Galties for all workstation depcqdt-... :..+~ts 01'a text primitive with a text bundle index. In GKS. this table contains entries consisting of text font and'precision, character expansion factor, character spacing and colour index.
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3.68 text font and together determine precision describes gram. In order of

font and precision, which the shape of the characters being output, on a particuiar'workstation. In addition, the the fidelity with which the other text aspects match those requested by an application proincreasing fidelity, the precisions are: STRING, CHAR and STROKE.

precision: An aspect of text in GKS, having two components,

3.69 translation; shift: The application of a constant displacement to the position of all or part of a display image. In GKS, this capability is restricted to segments. 3.70 trigger: A physical input device or set of devices that an operator can use to indicate significant moments in time. 3.71 valuator device: A GKS logical input device providing a real number. 3.72 viewport: An application program specified part of normalized device coordinate space. In GKS, t:tis definition is restricted to a rectangular region of normalized device coordinate space used in the definition of the normalization transformation. 3.73 window: A predefined part of a virtual space. In GKS, this definition is restricted to a rectangular region of the world coordinate space used for the definition of the normalization transformation. 3.74 workstation: GKS is based on the concept of abstract graphical workstations, interface through which the application program controls physitcal devices. which provide.the logical

3.75 Workstation Dependent Segment Storage (WDSS): Segment storage on a workstation graphical output. Segments cannot be transferred from WDSS to another workstation. 3.76 Workstation Independent Segment Storage (WISS): A special workstation stored and later transferred to other workstations.

that is used for

type, where segments can be'

3.77 workstation mandatory: Workstation mandatory descrii:c>sa property that is required to be realized identically on all workstations of a GKS implementation. 3.78 workstation transformation: A transformation that maps l 3e Loundary and interior of a workstation window into the boundary and interior of a workstation viewport {part of display space), preserving aspect ratio. In GKS, this transformation maps positions in normalized rl.. iice coordinates to device coordinates. The effect of preserving aspect ratio is that the interior of the work .: tion window may not map to the whole of the workstation viewport. 3.79 workstation viewport: A portion of display space currently SC< :. led for output of graphics. 3.80 workstation window: A rectangular represented on a display space. region within the norm;ii;zed device coordinate system which is pro-

3.81 world coordinate (WC): A device independent Cartesian ccordinute gram for specifying graphical input and output.

system used by the application
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4 The Graphical Kernel System

4.1 About this standard
4.1.1 Specification The set of functions known as the Graphical Kernel System shall be as described in clauses 4, 5 and 6 and annexes A and B. These functions are organized in nine upward compatible levels with increasing capabilities as described in 4.10. An implementation of GKS shall implement precisely the functions of one level. A GKS implementation shall be invalid if it lies between two defined levels or outside the defined levels. In an implementation, all graphical capabilities that can be addressed by GKS functions shall be used only via GKS. 4.1.2 Registration') For certain parameters of the functions, GKS defines value ranges as being reserved for registration. The meanings of these values will be defined using the established procedures. These procedures do not apply to values and value ranges defined as being workstation or implementation dependent; these values and ranges are not standardized.
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Introduction to CKS 4.2 Introduction to GKS

The Graphical
conliguration

Kernel System (GKS) provides a functional interface between an application program and a of graphical input and output devices. The functional interface contains all basic functions for interactive and non-interactive graphics on a wide variety of graphics equipment.

The interface is at such a level of abstraction that hardware peculiarities are shielded from the application program. As a result a simplified interface presenting uniform output primitives (POLYLINE, POLYMARKER, TEXT. FILL AREA, CELL ARRAY, GE,U5RALIZED DRAWING PRIMITIVE). and uniform input classes (LOCATOR, STROKE, VALUATOR, CHOICE. PICK, STRING) is obtained. In 4.3 the concepts of basic output. input and the organization of input and output sequences are outlined. A central concept both for structuring GKS and for realizing device independence is introduced, called the workstation. The facilities for picture manipulation and change are introduced via the segment facilities. the dynamic attributes and the transformations. The integral control over all these methods for change is further explained in 4.5.3 on workstations. The concept of multiple workstations allows simultaneous output to and input from various display systems. Facilities for internal and external stora'ge are provided by special workstations together with the possibility of transferring graphical entities directly from the special workstation for internal storage to other workstations. Not every GKS implementation needs to support the full set of functions. Nine levels are defined to meet the different requirements of graphics systems. Each GKS implementation precisely provides the functions of one level. The levels are upward compatible. GKS defines only a language independent nucleus of a graphics system. For integration into a language, GKS is embedded in a language dependent layer containing the language conventions, for example, parameter and name assignment. The layer model represented in figure 1 illustrates the the functions of the adjoining lower layers. In general layer, the language dependent layer. other application workstation capabilities that can be addressed by GKS role of GKS in a graphics system. Each layer may call the application program uses the application oriented dependent layers, and operating system resources. All functions are used only via GKS.

10
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Application Program

Application Oriented Layer

------7

Language Dependent Layer

Graphical Kernel System

OPERATING -Other Resources
Figure 1 - Layer model of GKS

SYSTEM

Graphical Resources
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4.3 cm The graphical output that is generated by GKS is built up from two groups of basic elements called output
primitives and primitive attributes. The output primitives are abstractions of basic actions a device can perform, such as drawing lines, and printing character strings. The attributes control the aspects of the output primitives on a device, such as linestyle, colour, character height and pick identifier. Non-geometric aspects, such as colour but not character height, can be controlled for each workstation individually, to make. best use of its capabilities. The graphical information that is input from a device, as a result of operator actions, is mapped by GKS onto six classes of input each represented .by a data type referred to as a logical input value. An instance of such a device representation is called a logical input device. The effect of input actions on the display surface, such as prompts and echoes, is controlled by GKS for each logical input device individually. The two abstract concepts (abstract output and abstract input) are the building blocks of a so-called abstract workstation. A workstation of GKS represents a unit consisting of zero or one display surfaces and zero or more input devices, such as keyboard, tablet and lightpen. The workstation presents these .devices to the application program as a configuration of abstract devices thereby shielding the hardware peculiarities. The geometrical information (coordinates) contained in output primitives, attributes and logical input values (locators and strokes) can be subjected to transformations. These transformations perform mappings between three coordinate systems, namely: a) World Coordinates b) Normalized tions; (WC), used by the application programmer; (NDC), used to define a uniform coordinate system for all workstaDevice Coordinates

c) Device Coordinates nates.

(DC), one coordinate system per workstation,

representing its display space coordi-

Output primitives and attributes are mapped from WC to NDC by normalization transformations, from NDC to NDC by segment transformations (see next paragraph), and from NDC to DC by workstation transformations. Locator input is mapped by an inverse workstation transformation from DC to NDC and by one of the inverse normalization transformations from NDC to WC. Output primitives and primitive attributes may be grouped together in a segment. Segments are the units for manipulation and change. Manipulation includes creation, deletion, and renaming. Change includes transforming a segment, making a segment visible or invisible, and highlighting a segment. Segments also form the basis for workstation independent storage of pictures at run time. Via this storage, which is set up as a special workstation called workstation independent segment storage, segments can be inserted and transferred to other workstations. The attributes which control the appearance of parts of the picture (output primitives, segments, prompt and echo types of input devices) on the display surface are organizedin a uniform manner. Two groups of attributes apply to the appearance of each output primitive: primitive attributes (that are workstation independent) and workstation attributes. Primitive attributes are specified modally and are bound to a primitive when it is created. The primitive attributes include all geometric aspects of primitives, such as character height for text and pattern size for fIl1 area. In addition, the non-geometric aspects of primitives are controlled by the primitive attributes in one of two ways. Either a single attribute is used to specify all the nongeometric aspects of the primitive by an index which points to a workstation dependent representation (set of values) or one attribute is used to specify each of the non-geometric aspects of the primitive in a workstation independent way. The former is referred to as bundled specification and the latter is referred to as individual .. specification. Workstation attributes include the actual representations on a workstation pointed to by indices used in bundled specification of non-geometric aspects. For example, the representations (or bundles) for polyline each contain values of linetype, linewidth scale factor and colour index. Workstation attributes also specify the colour and pattern tables and the control over deferral of picture change. Workstation attributes can be reset dynamically.

12
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The Graphical Kernel System The appearance of segments is controlled by segment attributes, which are segment transformation, visibility, highlighting, segment priority, and detectability. These may be reset dynamically. Segment attributes can be a basis for feedback during manipulations (for example, highlighting). The attributes which control the operation of logical input devices can be specified either upon initialisation or as part of input device setting, depending upon the attributes. Through initialisation, an initial value, a prompt and echo technique, and an area on the screen for echoing can be specified. A data record may further provide device specific attributes. Through input device setting, the operating mode may be selected and the echo may be switched on or off. The operating modes of logical input devices specify who (operator or application program) has the initiative: SAMPLE input is acquired directly by the application program; REQUEST input is produced by the operator in direct response to the application program; EVENT input is generated asynchronously by the operator and is collected in a queue for the application program. At run time GKS can be in one of five different operating states. Associated with each state are the set of GKS functions allowed in this state, and a set of state variables. The operating state concept and the state variables allow for proper specification of initialisations (for example, at OPEN WORKSTATION) and the effect of various functions, especially with respect to the maintenance of device independence. One special set of functions called inquiry functions is allowed in all states. They give read-only access to the state lists. In this way useful information can be provided when errors occur. Other inquiry, functions allow read-only access to the workstation descriptions, to allow the application program to adapt to particular workstation capabilities. Inquiry functions never cause errors. Instead they return information specifying ,whether a valid inquiry was made. GKS provides an interface to a system for filing graphical information for the purpose of external long term storage and exchange. The interface consists of a GKS Metafile output workstation, which writes to a socalled graphics metafile (which is sequential), and a GKS Metafile input workstation, which reads from the metafile. In addition to the normal functions for output to workstations, a GKS Metafile output workstation may accept items containing non-graphical information. Input from a metafile is controlled by read and interpret functions which have the same effect as invoking the corresponding functions directly from the application program.
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Graphical output 4.4 4.4.1

Graphical output
Output primitives

The graphical information that is generated by GKS and routed to all active basic pieces called..output primitives. GKS provides six output primitives:
._

workstations

is built up of

4
b)

POLY LINE:

GKS generates sequence.

a \ct of connected lines defined by a point

POLYMARKER: TEXT: FILL AREA:

GKS generates symbols of one type centred at given positions. GKS generates a character string at a given position. GKS generates a polygonal area which may be hollow or filled with a uniform colour, a pattern, or a hatch style. GKS generates an array of pixels with individual colours. GKS addresses special geometrical output capabilities of a workstation such as the drawing of spline curves, circular arcs, and elliptic arcs. The objects are characterized by an identifier, a set of points and additional data. GKS applies all transformations to the points but leaves the interpretation to the workstation.

c)

d) e)
f)

CELL ARRAY: GENERALIZED DRAWING PRIMITIVE(GDP):

4.4.2 Output primitive attributes Each output primitive potentially has three types of attribute (geometric, non-geometric and identification). The first two attribute types determine the exact appearance of the output primitive while the third attribute type is used in connection with input. The values of these attributes are set modally and are recorded in the GKS state list. A separate GKS function is provided for each primitive attribute (except the ASFs: see later in this sub-clause), to allow the application program to specify the value of an attribute without unnecessarily specifying the values of other attributes. During creation of an output primitive (that is, when one of the GKS output primitive functions is invoked) these values are bound to the primitive and cannot be changed afterwards. Attributes of the first type control the geometric aspects of primitives; these are aspects which affect the shape or size of the whole primitive (for example, CHARACTER HEIGHT for TEXT). Hence, they are sometimes referred to as geometric attributes. Attributes of this type are workstation independent and, if they represent coordinate data (points or displacements), are expressed in world coordinates (for example, CHARACTER HEIGHT is expressed in world coordinates but TEXT PATH takes one of a set of enumerated values). They are defined separateiy for each primitive and a primitive may have zero, one or many geometric attributes. Current values of (workstation independent) geometric attributes, which are expressed in world coordinates, are stored in world coordinates. When they are bound to their respective primitives, the values are subject to the same transformations as the geometric data contained in the definition of the primitive. Hence, current values are unaffected by changes in the normalization transformation and the workstation transformation. Attributes of the second type control the non-geometric aspects of primitives; these are aspects which merely affect a primitive's appearance (for example, linetype for POLYLINE, or colour index for all primitives except CELL ARRAY) or the shape or size of the component parts of the primitive (for example, marker size scale factor for POLYMARKER). Non-geometric aspects do not represent coordinate data. The nongeometric aspects of a primitive may be specified in one of two ways, namely via a bundle or individually. per primitive, called the For specification of aspects via a bundle, there is one attribute <primitive> INDEX. This attribhte is an index into a bundle table, each entry of which contains all the 14
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non-geometric aspects of the primitive.. There is a separate bundle table for each primitive with the exception of GENERALIZED DRAWING PRIMITIVE and CELL ARRAY (see later in this sub-clause). The nongeometric aspects are workstation dependent in this method of specification and each workstation has its own set of bundle tables (stored in the workstation state list). Th.e values in a particular bundle (or entry in the bundle table) may be different for different workstations. For individual specification of aspects, there is a separate attribute for each non-geometric aspect. As with the attributes controlling the geometric aspects, these attributes are workstation independent and are stored in the GKS state list. Since each non-geometric aspect only occurs in one primitive bundle type, each of these attributes applies to only one primitive type. For a given non-geometric aspect, the values that can be assigned to the appropriate bundle component are the same as the values that can be assigned to the corresponding attribute for individual specification. Since the bundles are set separately for each workstation, the values of their components are restricted to the valid values for that workstation. In the case of individual attribute specification, such restrictions are not imposed. Default actions for the display of a primitive are defined to occur if it is created with a value of an individually specified attribute that is invalid on a particular workstation. As indicated above, GENERALIZED DRAWING PRIMITIVE (GDP) and CELL ARRAY do not have associated bundle tables nor corresponding individually specified attributes. The GDP may use the most appropriate bundle tables or sets of individually specified attributes for each GDP function. For example, if one GDP function is essentially a FILL AREA, then the fill area bundle table or the set of individually specified fill area attributes would be used. CELL ARRAY contains colour index information as part of its definition but has no other non-geometric aspects and so does not use a bundle table nor does it have a set of individually specified attributes. The method of specification of the non-geometric aspects of a primitive may be chosen separately for each aspect. A further group of primitive attributes, called ASPECT SOURCE FLAGS (ASFs), take the values INDIVIDUAL and BUNDLED to specify the choice. As with the other primitive attributes, these attributes are workstation independent and are stored in the GKS state list. There is one ASF for each non-geometric aspect of each primitive. The initial values of all the ASFs are the same; this may be either BUNDLED or INDIVIDUAL, the choice being implementation dependent. If the initial values are not altered, the system will operate a) as if individual specification of non-geometric aspects were not a system feature, if the initial values of all the ASFs are BUNDLED; b) as if specification of non-geometric of all the ASFs are INDIVIDUAL. aspects via a bundle were not a system feature, if the initial values This

The flags may be set at any time when GKS is open by the function SET ASPECT SOURCE FLAGS. enables some non-geometric aspects of a primitive to be specified individually and others via a bundle. When a primitive is displayed, the values of the non-geometric mined as follows.

aspects with which it is displayed are deteris the value of the

c) If the ASF for an aspect is INDIVIDUAL, the value used on all workstations corresponding individually specified attribute of that primitive.

d) If the ASF for an aspect is BUNDLED, the value used on a workstation is obtained via the bundle table for that primitive on the workstation; the corresponding component of the bundle, pointed to by the bundle index, is used. If colour is a non-geometric aspect of a primitive, then it is specified as an index into a separate colour table. There is only one colour table per workstation into which all the colour indices point. Similarly, other entries in a bundle, or corresponding individually specified attributes, may be indices either into another workstation table (for example, style index when interior style PATTERN is used) or into a fixed list (for example, linetypes for polyline). There is precisely one attribute of the third type per primitive, nkmely PICK IDENTIFIER. identifying a primitive, or a group of primitives, in a segment when that segment is picked. This is used for
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The attributes which apply to each output primitive (attributes controlling non-geometric attributes and PICK IDENTIFIER) are:

4

POLYLINE:

POLYLINE INDEX LINETYPE LINEWIDTH SCALE POLYLINE COLOUR LINETYPE ASF LINEWIDTH SCALE POLYLINE COLOUR PICK IDENTIFIER

FACTOR INDEX FACTOR ASF INDEX'ASF

r)

POLYMARKER:

POLYMARKER INDEX MARKER TYPE MARKER SIZE SCALE FACTOR POLYMARKER COLOUR INDEX MARKER TYPE ASF MARKER SIZE FACTOR ASF POLYMARKER COLOUR INDEX ASF PICK IDENTIFIER TEXT INDEX TEXT FONT AND PRECISION CHARACTER EXPANSION FACTOR CHARACTER SPACING TEXT COLOUR INDEX TEXT FONT AND PRECISION ASF CHARACTER EXPANSION FACTOR ASF CHARACTER SPACING ASF TEXT COLOUR INDEX ASF CHARACTER HEIGHT CHARACTER UP VECTOR TEXT PATH TEXT ALIGNMENT PICK IDENTIFIER FILL AREA INDEX FILL AREA INTERIOR STYLE FILL AREA STYLE INDEX FILL AREA COLOUR INDEX FILL AREA INTERIOR STYLE ASF FILL AREA STYLE INDEX ASF FILL AREA COLOUR INDEX ASF PATTERN SIZE PATTERN REFERENCE POINT PICK IDENTIFIER PICK IDENTIFIER Zero or more of the sets e) to i) except that PICK IDENTIFIER always an attribute . is

Id

TEXT:

h)

FILL AREA:

i)

CELL ARRAY: GENERALIZED DRAWING PRIMITIVE:

3

Figure 2 shows the binding of the attributes.

16

IS : 12369 - 1987 IS0 7942 - 1986 The Graphical Kernel System Graphical output

CKS

FUNCTIONS

GKS STATE LIST WORKSTATION
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AlTRmIJTEs *

1 1
POLYUARKEX ArlRmuTgs * Al7wBuTEz? * FILLAREA AlTRIBuTgs * PICK IDENTIFIER
L

SEGMENT ATIWBUTES

ATTRIBUTES

SEGMENT TRANSPORMATKIN
VISI2lLMV IiICHUGHTING SEGIIEIUT PRIORITY DETECTABILITY

POLYUNg RH'R. POLYURggR WPR. TEXTREPR. FIILAREARgPR. PAlTERN REPR. COUXJR Rx%. DEFEWUL STATE
WORKSTATlON TRANSF'ORMATION

POLYLINE

-i

I

IA
I

1

POLYYURKER PILLAREA CELLARMY -i G.D.P.
* PICKqENTMER is separated from the other attributes
for a primitive only in this figure. See 4.4.2 for a fbll list.

Figure 2 - Binding of attributes
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The attributes for each primitive, other than PICK IDENTIFIER, are described in 4.4.3 to 44.8. PICK IDENTIFIER is described in more detail in 4.7.1. In the descriptions, attributes appear in upper case (for example, the attributes CHARACTER HEIGHT and PICK IDENTIFIER); aspects appear in both upper and lower case, according to their context. Geometric aspects are always controlled by geometric attributes and so appear in upper case (for example, the aspect CHARACTER HEIGHT). Non-geometric aspects may be controlled via a c primitive > INDEX or by individually specified attributes. Non-geometric aspects appear in lower case unless the corresponding individually specified attributes are being used which appear in upper case (for example, the aspect linetype but the individu,li:y specified attribute LINETYPE). The entries in the bundle, pattern, and colour tables may be set separately for each workstation. Some standard definitions for table entries are contained in the workstation description table and are used as initial values. The application program may select a standard definition or may define the values of a specific entry explicitly. Only the most commonly used (or anticipated) combinations of values need be predefined for each output type workstation. At least those predefined entries with indices up to the minimum number of predefined &tries at a given level (see 4.10.3) are distingishable from each other. Other combinations of values can be specified by the SET <primitive ( PATTERN j COLOUR > REPRESENTATION function, possibly after inquiring the workstation capabilities. The tables, which are on every workstation of category OUTPIJT, OUTIN or MO (i.e. they are workstation attributes), are: polyline bundle table polymarker bundle table text bundle table fill area bundle table pattern table colour table The values in these tables may be (dynamically) changed. In fact, the only way of changing the aspects of a primitive which are stored in a bundle table is by changing that table. However, note that a change in a bundle table entry car, only be reflected in a displayed primitive if the values of the corresponding ASFs (of that primitive) for the aspects in the bundle table are BUNDLED. The entry "dynamic modification accepted' in the workstation description table indicates which changes k) lead to an implicit regeneration (may be deferred) (IRG); 1) can be performed immediately (IMM). The deferral state is explained in more detail in 4.5.3. If changes can be performed immediately, those changes may affect primitives outside segments in addition to those inside segments. 4.4.3 Polyline attributes Polyline has no geometric attributes. The representation of poiyline on the workstation is controlled by the POLYLINE INDEX, or the set of individually specified polyline attributes (LINETYPE, LINEWIDTH SCALE FACTOR, and POLYLINE COLOUR INDEX) or some combination of the two, depending upon the values of the ASFs for linetype, linewidth scale factor and polyline colour index. The POLYLINE INDEX is a pointer into the polyline bundle table, each entry of which contains values for linetype, linewidth scale factor and polyline colour index. Linetypes 1 to 4 are solid, dashed, dotted and dashed-dqtted. Every workstation of category OUTPUT or OUTIN realizes linetypes 1 to 4 with recognizable styles. Linetypes greater than 4 are reserved for registration (see 4.1.2). Linetypes less than 0 may be available but their styles are implementation dependent. The linetype specifies a sequence of line segments and gaps which are repeated to draw a polyline. It is workstation dependent whether this sequence is restarted or continued at the start of the polyline, at the start of a clipped piece of a polyline, and at each vertex of a polyline. The linewidth is calculated as a nominal linewidth multiplied by the linewidth scale factor. mapped by the workstation to the nearest available linewidth. 9 This value is
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The Graphical Kernel System 4.4.4 Polymarker attributes Polymarker has no geometric attributes. The representation of polymarker at the workstation is controlled by the POLYMARKER INDEX, or the set of individually specified polymarker attributes (MARKER TYPE, MARKER SIZE SCALE FACTOR, and POLYMARKER COLOUR INDEX) or some combination of the two, depending upon the values of the ASFs for marker type, marker size scale factor, and polymarker colour index. The POLYMARKER INDEX is a pointer into the polymarker bundle table, each entry of which contains values for marker type, marker size scale factor and polymarker colour index. Marker types 1 to 5 are dot, plus sign, asterisk, circle, and diagonal cross each centred on the positions they are identifying. Every workstation of category OUTPUT or OUTIN realizes marker types 1 to 5 with recognizable shapes at the given positions. Marker types greater than 5 are reserved for registration (see 4.1.2). Marker types less than 0 may be available but their forms are implementation dependent. The marker size is calculated as a nominal size multiplied by the marker size scale factor. This size is mapped by the workstation to the nearest available size. Marker type 1 is always displayed as the smallest displayable dot. The marker is visible if, and only if, the marker position is within the clipping rectangle. tially visible markers is workstation dependent. 4.4.5 Text attributes Text has the geometric attributes CHARACTER HEIGHT, CHARACTER UP VECTOR, TEXT PATH, and TEXT ALIGNMENT which are specified and used as described in this sub-clause. Text also has two implicitly specified geometric attributes CHARACTER WIDTH and CHARACTER BASE VECTOR. These are implicitly specified by the functions SET CHARACTER HEIGHT and SET CHARACTER UP VECTOR respectively. They otherwise behave like ordinary geometric attributes (their values are bound to TEXT primitives when the primitives are created and cannot be changed afterwards and these values are subject to the same transformations as the geometric data contained in the definition of the primitive). The representation of text at the workstation is controlled by the TEXT INDEX,,or the set of individually specified text attributes (TEXT FONT AND PRECISION, CHARACTER EXPANSION FACTOR, CHARACTER SPACING, and TEXT COLOUR INDEX) or some combination of the two, depending upon the values of the ASFs for text font and precision, character expansion factor, character spacing and text colour index. The TEXT INDEX is a pointer into the text bundle table, each entry of which contains values for text font and precision, character expansion factor, character spacing and text colour index. Precise control of the appearance of TEXT on a workstation is provided by the following aspects: CHARACTER HEIGHT, CHARACTER WIDTH, character expansion factor, TEXT PATH, CHARACTER UP VECTOR, CHARACTER BASE VECTOR, character spacing and TEXT ALIGNMENT. However, the use of these values in displaying text is determined by the setting of the text font and precision aspect (font and precision are two components of the same aspect). The CHARACTER HEIGHT specifies the nominal height of a capital letter character. The CHARACTER WIDTH specifies the nominal width/of a character; the actual width depends upon the width to height ratio of the character indicated by the font designer and may vary from character to character. The character expansion factor specifies the deviation of the width to height ratio of the character from the ratio indicated by the font designer. The CHARACTER UP VECTOR gives the up direction of a character. The CHARACTER BASE VECTOR gives the direction of the baseline of a character. Only the directions, not the lengths, of these vectors are relevant. TEXT PATH has the possible values RIGHT, LEFT, UP and DOWN. It specifies the writing direction of the text string. For RIGHT, the text string is written along a baseline in the direction of the CHARACTER BASE VECTOR. For LEFT, the baseline direction is the opposite direction of the CHARACTER B E VECTOR. For UP, the character path coincides with the direction of the CHARACTER UP VECT z R. For DOWN, it is the opposite direction of the CHARACTER UP VECTOR. For the UP and DOWN text path directions the characters are arranged so that the centres of the character bodies are on a straight line in the direction of the CHARACTER UP VECTOR. The clipping of parGraphical output
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The character spacing value specifies how much additional space is to be inserted between two adjacent character bodies. If the value of character spacing is zero, the character bodies are arranged one after the other along the TEXT PATH, without any additional space between. A positive value of character spacing will insert additional space between character bodies. A negative value of character spacing will cause adjacent character bodies to overlap. Character spacing is specified as a fraction of the font nominal character height. The effect of the aspects CHARACTER HEIGHT, CHARACTER WIDTH, character expansion factor, TEXT PATH, character spacing and text font is to define an (imaginary) rectangle with its sides parallel to the x and y axes, enclosing the text. The bounds of this enclosing rectangle are as follows. For TEXT PATH = LEFT or RIGHT, the height of the rectangle is the height of the character body of the specified font; the left side of the rectangle is the left side of the character body of the leftmost character and the right side of the rectangle is the right side of the character body of the rightmost character. For TEXT PATH = UP or DOWN, the top of the rectangle is the top of the character body of the topmost character and similarly, the bottom of the rectangle is the bottom of the bottommost character; the width of the rectangle is the width of the widest character in the specified font. The effect of the CHARACTER UP VECTOR and CHARACTER BASE VECTOR attributes is to transform the enclosing rectangle, thus defining an enclosing parallelogram, the text extent parallelogram (the rectangle has been rotated and sheared). The TEXT ALIGNMENT attribute controls the positioning of this text extent parallelogram in relation to the text position. For simplicity the TEXT ALIGNMENT is described in terms of the default CHARACTER UP VECTOR and CHARACTER BASE VECTOR, when the text extent parallelogram is actually a rectangle. The horizontal component of TEXT ALIGNMENT has four values: LEFT, CENTRE, RIGHT and NORMAL. If the horizontal component is LEFT, the left side of the text extent parallelogram passes through the text position. Similarly, if the value is RIGHT, the right side of the text extent parallelogram passes through the text position. If the horizontal component is CENTRE, the text position lies midway between the left and right sides of the text extent parallelogram. Thus, if TEXT PATH = UP or DOWN, the straight line passing through the centrelines of the characters also passes through the text position. The vertical component of TEXT ALIGNMENT has six values: TOP, CAP, HALF, BASE, BOTTOM and NORMAL. These each correspond to one of the font specific horizontal lines in the definition of a character (see figure 3). A value of TOP causes the top of the text extent parallelogram to pass through the text position. A value of CAP causes the text position to lie on the capline of the whole string (TEXT PATH = LEFT or RIGHT) or on the capline of the topmost character in the string (TEXT PATH = UP or DOWN), A value of HALF causes the text position to lie on the halfhne of the whole string (TEXT PATH = LEFT or RIGHT) or on a line halfway between the halflines of the top and bottom characters (TEXT PATH = UP or DOWN). A value of BASE causes the text position to lie on the baseline of the whole string (TEXT PATH = LEFT or RIGHT) or on the baseline of the bottom character in the string (TEXT PATH = UP or DOWN). A value of BOTTOM causes the bottom of the text extent parallelogram to pass through the text position. In the genera1 case, the orientation referred to as horizontal is that of the CHARACTER BASE VECTOR with RIGHT representing direction of that vector and LEFT being opposite to it. Similarly the orientation referred to as vertical is that of the CHARACTER UP VECTOR with UP representing the direction of that vector and DOWN being opposite to it. Either component of TEXT ALIGNMENT can take the value NORMAL. For each value of TEXT PATH, the effect of a particular component being NORMAL is equivalent to one of the other values of that component. In each case, the equivalent alignment value is chosen to achieve a natural alignment for that TEXT PATH value. The complete list of equivalent values is: NORMAL Horizontal and V%&l?&&men~; p--w
I (RIGHT, BASE) I (CENTRE. BASE) j (CENTRE. TOP) . .._. -.--~- - ..---...-_.. / -- ~__._._
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Figure 3 - Font description coordinate system The initial values of the geometric text attributes are: CHARACTER CHARACTER
1 :;:f

HEIGHT UP VECTOR

WC WC

E:NMENT

0.01 (i.e. 1% of the height of the default window) (0,l) RIGHT (NORMAL, NORMAL) _I

and the initial values of the implicitly specified geometric text attributes are: CHARACTER WIDTH WC 0.01 (i.e. -the same value as the initial value of CHARACTER HEIGHT) CHARACTER BASE VECTOR WC (1,0) 7 Text font and precision together constitute one aspect. The text font value is used to select a particular font on the workstation. Every workstation supports at least one font that is able to generate a graphical represen- tation of the characters defined in IS0 645. This is font number 1. Font numbers greater than 1 are reserved' for registration (see 4.1.2). Font numbers less than 0 may be supported but are implementation dependent. The text precision value is used to select the `closeness' of the text representation at the workstation in relation to that defined by the workstation independent text attributes and the transformation and clipping currently applicable. The text precision value hL:s the following possible values: a) STRING: The TEXT character string is generated in the requested text font and is positioned by aligning.the TEXT output primitive at the given text position. CHARACTER HEIGHT, CHARACTER WIDTH and character expansion factor are evaluated as closely as reasonable, given the capabilities of the workstation. CHARACTER UP VECTOR, CHARACTER BASE VECTOR, TEXT PATH, TEXT ALIGNMENT and character spacing, need not be used. Clipping is done in an implementation and workstation dependent way.
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The TEXT character string is generated in the requested text font. For the representation of each individual character. the aspects. CHARACTER HEIGHT, CHARACTER WIDTH, the up direction of the CHARACTER UP VECTOR, the baseline direction of the CHARACTER BASE VECTOR, and character expansion factor are evaluated as closely as possible, in a workstation dependent way. The spacing used between character bodies is evaluated exactly; the character body, for this purpose, is an ideal character body, calculated ,precisely from the text aspects and the font dimensions. The position of the resulting text extent parallelogram is ietermined by the TEXT ALIGNMENT and the text position. Clipping is performed at least on a character by character basis: The text character string in the requested text font is displayed at the text position by applying all text aspects. The character string is clipped exactly at the clipping rectangle.

c) STROKE:

STROKE precision does not necessarily mean vector strokes; as long as the representation adheres to the rules governing STROKE precision, the font may be realized in any form, for example by raster fonts. A GKS output level 0 implementation supports text precisions STRING and CHAR. Above output level 0, all text precisions are supported as follows. A workstation may use a higher precision than the one requested for this purpose i.e. if STROKE precision is supported in a particular font, the implication is that both STRING and CHAR precision are available in that font. However it is not necessary for a workstation to support all precisions for a given font (i.e. for a given font, STROKE can be missing or both STROKE and CHAR can be missing). Text font and precision are workstation mandatory. That is, for any GKS level supporting a STROKE precision font, every workstation of a particular installation supports at least one STROKE precision text font. This is font number 1, containing the character set defined by IS0 646. This implies that, for STROKE precision text, some sort of software character generator is required for those implementations that have inadequate hardware. Not all workstations need to support all fonts, but for those that do, the same font number is used to select that font on all workstations of a particular installation. Fonts are defined only within the GKS implementation. The font designer specifies the shape of the symbol representing each character in a local 2D Cartesian font coordinate system. Fonts are either monospaced or proportionally spaced. Each character in a font coordinate system has an associated character body, a font baseline, a font haltline, a capline and a centrelme (see figure 3). For monospaced fonts, the character bodies of all characters have the same size. For proportionally spaced fonts, the width of the bodies may differ from character to character. The character body edges are parallel to the axes of the font coordinate system. The font baseline, the font halfline and the capline are parallel to the x-axis of the font coordinate system, and within the vertical extent of the body. The position of the font halfline is defined by the font designer for use in aligning text strings. The centreline is parallel to the y-axis and bisects the body. Their exact positions are specified by the font designer. The height of a character in the font coordinate system is given by the height from the font baseline to the capline. The width of a character is given by the width of the character body. The width of a character may include space on either side of the character and this space is generally evenly split between the left and right sides of t,4e character. It is assumed that the characters lie within their body, except that kerned characters may exceed the side limits of the character body. In general, the top limits of the bodies for a font are identical with, or very close to, the typographical capline or ascender line, and the bottom limit to the descender line. The space, if any, between the topline and the capline may be used for an additional mark over the character, for example an accent. However, these and other details are purely for the use of the font designer. The intention is only that characters placed with their bodies touching in the horizontal direction should give an appearance of good normal spacing, and characters touching in the vertical direction will avoid clashes between ascenders and descenders (typographically `set solid'). Since the values of CHARACTER HEIGHT, CHARACTER WIDTH, CHARACTER UP VECTOR and CHARACTER BASE VECTOR are given in world coordinate units, but the characters are genfrated on the workstation in device coordinates, using the workstation dependent font and precision, the geometric attributes need to be transformed in such a way that the workstation can generate the characters in the way intended.
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character

height

CHARACTER HEIGHT = 1,CHARACTER UP VECTOR = (OJ), TEXT PATH = RIGIiTJ'EXTALIGNYENT = (NORMAL,NOWAL)

CHARACTER HEIGHT = 0.5, CHARACTER UP VECTOR = (OJ) TEXI' PATH = RIGHT,TEXTALIGNMENT= (NOR~W,NORWL)

CHARACTERHEIGHT= 1,CHARACTER UP VECTOR = (0.1). TEXT PATH = RIGHT.TEXTALIGNMENT= (RIGHT,TOP) CHARACTER HEIGHT =1 CHARACTERUPVECTOR = I TEj(T PATH USDOW?J(~'~) TEXTALIGNMENT = (NORYAL,NORWU) 1 CHARACTER HEIGHT =l CHARACl'ER UP VECTOR -(-1,o) TEXTPATH =RIGHT TEXT ALIGNMENT = (NoFwM,,NoRIW;)

X text position ______ baseline or centreline ---text extent rectan le (indicated for PATB = DOWN)

NOTES I Examples are illustrated with STROKE precision, a character expansion factor of 1 and a zero character spacing. 2 Capline = topline in these examples. 3 Changed attributes are underlined.

Figure 4 - Effects of changes in geometric text attributes
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CHARACTER EXPANSION FACTOR = 1,CHARACTER SPACING = 0

CHARACTER EXPANSION FACTOR = 0.75, CHARACTER SPACING = 0 /

CHARACTER EXPANSION FACTOR = 1,CHARACTER SPACING = 0.3

NOTES 1 Examples are illustrated with default values of the geometric text attributes and with STROKE precision. 2 Changed aspects are underlined. .

Figure 5 - Effects of changes in non-geometric text aspects
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CHARACTEREXkSIoNFACTOR =l CHARACTER SPACING=0 CHARACTER HEIGHT 11.414 CHARACTERUP VECTOR =(-1.11 TEXT PATH =RIGHT Tmr ALIGNMENT=(NOR)~AL.NORWU)

CHARACTER EXPANSIONFAtiOR =l CHARACTER SPACING= -0.3 CHARACTER HEIGHT =l CHARACTER UP VECTOR =(O.l) TEXTPATH-LEFT mm ~uG~m+rr =(NOR~NORIIAL) CHARACTER EXPANSIONFACTOR =l CHARACTER SPACING=0 CHARACTERHEIGHT=l CHARACTER UP VECTOR = (-1.0) TEXT PATH=RIGHT TEXT ALIGNMENT=(CENTRE,TOP)

_

CHARACTEREXPANSIONFACTOR =JI CHARACTER SPACING= 0 CHARACTER HEIGHT =l CHARACTER UP VECTOR =(O,l) m PATH =DOWN TEXTALIGNMENT=(LWr&ALF)
NOTE #S I Changes from the top example of figures 4 and 5 are underlined. 2 In the last example, halflioes of all characters are shown.

Figure 6 - Effects of combiaed change-sin text

aspects
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NOTE - Changes from the top example of figures 4 and 5 are underlined.

Figure 7 - Effects of several changes in text aspect8
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World coordinates
CHARACTERUP VECTOR = (-1,l)

I

I , I ,

8

4
After a normalization transformation which scales x by a factor of 3 compared with y.

After a normalization transformation which scales x and y equally.

Figure 8 - Effects of different normalization transformations on text in STROKE

precision
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The effect to be achieved is now described. Topther with the text coding, a height vector parallel to the CHARACTER UP VECTOR with length equal to CHARACTER HEIGHT, and a width vector parallel to the CHARACTER BASE VECTOR with length equal to CHARACTER WIDTH, are passed down the viewing pipeline. These vectors are transformed by the normalization transformation, by a segment transformation if within a segment, and by the workstation transformation. They are also stored in segments. Then the vectors can be used by the workstation character generator. Thus, the shape of individual characters can be transformed by a normalization transformation that is unequal in x and y and by a segment transformation. On the workstation, the height of a character is given by the length of the transformed height vector; the character up direction is given by the direction of the transformed height vector; the width of a character is given by the length of the transformed width vector multiplied by the font width to height ratio for the character and by the character expansion factor; the character base direction is given by the direction of the transformed width vector. The characters are arranged together in a text extent parallelogram, depending on the values of TEXT PATH and character spacing. The'text extent parallelogram is then positioned according to the value of TEXT ALIGNMENT and the text position, contained in the definition of the TEXT primitive. Figures 4 to 7 give examples of the effects of different values of text aspects. Figure 8 gives examples of the effect of different normalization transformations on the displayed form of the text. 4.4.6 Fill areir attributes Fill area has the geometric attribute P,4TTERN REFERENCE POINT. It also has two implicitly specified geometric attributes PATTERN WIDTH VECTOR and PATTERN HEIGHT VECTOR. These are implicitly specified by the function SET PATTERN SIZE. Like ordinary geometric attributes, their values are bound to FILL AREA primitives when the primitives are created and cannot be changed afterwards and these values are subject to the same transformations as the geometric. data contained in the definition of the primitive. The usage of the fill area geometric attributes is described later in this sub-clause. The representation of fill area at the workstation is controlled by the FILL AREA INDEX, or the Set of individually specified fill area attributes (FILL AREA INTERIOR STYLE:, FILL AREA STYLE INDEX, and FILL AREA COLOUR INDEX) or some combination of the two, depending upon the values of the ASFs for fill area interior style, fill area style index, and fill area colour index. The FILL AREA INDEX is a pointer into the fill area bundle table, each entry of which contains values for the fill area interior style, fill area style index and fill area colour index. The fill area idterior style is used to determine in what style the area should be filled. ' It has the following values: a) HOLLOW: No filling, but draw the bounding polyline, usmg the fill area colour index currently selected (either via the fill area bundle or individ;lally, depending upon the corresponding ASF). The linetype and linewidth are implementation dependent. Fill the interior of the polygon using the fill area colour index currently selected (either via the fill area bundle or ir.\dividually, depending upon the corresponding ASF). Fill the interior of the polygon using the fill area style i&ex currently selected (either via thi fill area bundle or individually, depending upon the corresponding ASF) as an index into the pattern table. In this context. the fill area style index is sometimes referred to as the pattern index. Fill the interior of the l)olygon using the fill area colour index and the fill area style index currently selected. (eith'er via the fill area bundle or individually, depending upon the corresponding A!SFs). The fill area style index is used as a pointer into the list of hatch styles, in which case it in sometimes referred to as the hatch index.

b) SOLID: c) PATTERN:

d) HATCH:

For interior : t de PATTERN, the pattern is defined by the pattern representation, which spelifies an array (DX x DY) 0:` zoicpur indices, that Rre poim;ers into the colour table. The size (and position of the start of the pattern are c!c:termined by a pattc::-1 box. `.The pattern box, which is a parallel~ogram. is defined by the PATTERN WIDTH VECTOR and the PATTERN HEIGHT VECTOR locate,d relative to the PATTERN

28

ISr12369-1987 IS0 7942 - 1986
The Graphical Kernel System Graphical output

REFERENCE POINT. The pattern box is conceptually divided into a grid of DX x DY cells. The colour index array `is associated with the cells as follows: the element (l,DY) is associated with the cell having the PATTERN REFERENCE POINT at one comer; elements with increasing first dimension are associated with successive cells in the direction of the PATTERN WIDTH VECTOR; elements with decreasing second dimension are associated with successive cells in the direction of the PATTERN HEIGHT VECTOR. The attributes defining the pattern box are subject to all the transformations producing a transformed pattern box. The pattern is mapped onto the polygon by conceptually replicating the transformed pattern box in directions parallel to its sides until the interior of the complete polygon is covered. Mapping the transformed pattern cells to the pixels of a raster display is performed by the following rules; e) If the centre of a pixel lies inside the parallelogram defined by the transformed cell, its colour is set; f) The pixel is assigned the colour of the cell corresponding to the pixel's centre. patterns, a suitable action is to genFor a workstation which can implement patterns but not transformable erate non-transformed patterns to fill a polygon.

For interior style HATCH, the hatch index selects among hatch styles: hatch styles greater than 0 are reserved for registration (see 4.1.2); hatch styles less than 0 are workstation dependent. Whether hatching is affected by transformations or not is workstation dependent. Interior style HOLLOW is available on every workstation of category OUTPUT or OUTIN. tion dependent which of the interior styles SOLID, PATTERN and HATCH are available. 4.4.7 Cell array attributes Cell array has no attributes other than PICK IDENTIFIER. However, an array of colour indices, which are pointers into the colour table, is part of the definition of a cell array. 4.4.8 Generalized Drawing Primitive attributes Generalized Drawing Primitive(GDP) has no explicit geometric attributes. Such information may be specified in the GDP data record. The representation of the GDP at the workstation is controlled by zero or more of the sets of polyline, polymarker, text and fill area attributes (see 4.4.2). Whether bundle indices or associated individually specified attributes are used depends upon the values of the appropriate ASFs. The sets of attributes most appropriate for the specified GDP function are selected for the GDP as part of the definition of the GDP and are recorded in the workstation description table. Similarly, if a GDP is essentially a cell array, then an array of colour indices would be specified in the GDP data record. 4.4.9 Colour In GKS, colour is specified in a number of different situations. It may be an aspect of a primitive, in which case it is specified either in the bundle for that primitive or by the individual colour attribute for that primitive. It may be part of a pattern for FILL AREA, in which case an array of colours is specified, or it may be part of a primitive itself, namely CELL ARRAY, when an array of colours is also specified. In each case, the colour is specified as an index into a colour table on the workstation. On each workstation, there is one colour table into which all the colour indices point. The size of the colour table is workstation dependent but entries 0 and 1 always exist. Entry 0 corresponds to the background colour. The background &our is the colour of the display surface after it has been cleared. Entry 1 is the default foreground colour and entries higher than 1 correspond to alternative foreground colours. Entries in the table may be set by the function SET COLOUR REPRESENTATION which specifies the colour as a combination of red, green, and blue intensities. The specified colour is mapped to the nearest available by the workstation. On some workstations it may not be possible to change the background colour, and in this case the mapping of a specific colour to the nearest available for the background colour may be different from the mapping of the same colour for the foreground colours. Some workstations are not capable of displaying colours (for example, workstations only cahable of displaying colours with equal red, green, and blue intensities or workstations only capable of displaying colours which are different intensities of the same colour); these are referred to as monochrome workstations.
29
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Whether a workstation is capable of colour is recorded in the `colour available' entry in the workstation description table. On mon&hrome workstations, the intensity is, computed from the colour values in a workstation dependent way.
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4.5 Workstations
4.5.1 Workstation characteristics GKS is based on the concept of abstract graphical workstations. These provide the logical interface through which the application program controls physical devices. Certain special workstations provide facilities for the storage and exchange of graphical information. For every type of workstation present in a GKS implementation (except for the special workstations), there exists a workstation description table which describes the capabilities and characteristics of the workstation. The application program can inquire which capabilities are available and adapt its behaviour accordingly. If a capability is requested that a particular workstation does not provide, a standard error reaction is defined. Certain minimal . capabilities of a workstation are detailed in 4,.10.
,

An abstract graphical workstation with maximum capabilities a) has one addressable display surface of fixed resolution; b) allows only rectangular parts); display spaces (the display space does not consist of a number of separate

c) permits the specification and use of smaller display spaces than the maximum while guaranteeing that no display image is generated outside the specified display space; d) supports several linetypes, text fonts, character sizes, etc., to allow output primitives to be drawn with different aspects; e) has one or more logical input devices for each input class; f) permits REQUEST, SAMPLE and EVENT type input; g) allows logical input devices to be set in REQIJES;T, SAMPLE or EVENT mode independently of each other; h) stores segments and provides facilities for changing and manipulating them. In practice, the workstation is not necessarily equipped with all of these capabilities. Each workstation has a type. Each workstation type falls into one of six categories: OUTPUT INPUT OUTIN WISS MO MI Output Input Output and input Workstation Independent Segment Storage(WISS) GKS Metafile (GKSM) output GKSM input

I

A workstation of category OUTPUT has only output capabilities. It can display all output primitives, with the possible exception of the GENERALIZED DRAWING PRIMITIVE which is optional. Minimal requirements for displaying TEXT and FILL AREA primitives are listed in 4.4, and for CELL ARRAY in 5.3. \ GKS allows the appearance of output primitives to vary between workstations, thus allowing advantage to be taken of their differing capabilities. The facilities which allow this variation are: polyline representation (see 4.4) polymarker representation (see 4.4) . text representation (see 4.4) fill area representation (see 4.4) pattern representation (see 4.4) colour representation (see 4.4) deferral state (see 4.5.3) workstation transformation (see 4.6.3)
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Figure 2 (see 4.4) illustrates the binding of the workstation attributes. A workstation of category INPUT has at least one logical'input device, but no output capability. A workstation of category OUTIN has the characteristics of both an OUTPUT and INPUT workstation. In addition, the existence of a workstation in this category in a GKS implementation gives rise to additional requirements regarding logical input devices (see 4.8.1). The last three categories WISS, MO and MI are special GKS .facilities that provide a means for temporarily or permanently storing graphical information. They are treated as workstations for the purposes of control, but otherwise have quite different characteristics (see 4.7.5 and 4.9). Clause A.5 of annex A gives a complete listing of all GKS functions which apply directly or indirectly to each category of workstation. Actual workstations may provide more capabilities than those listed in the workstation description table. These cannot be used by GKS. However, if the workstation itself provides sufficient intelligence,. the additional capabilities may be accessed via the GENERALIZED DRAWING PRIMITIVE or ESCAPE functions, or used locally by the workstation operator. As an example, if a workstation has two display surfaces, the operator may switch locally from one to the other without notifying GKS or the application program. More than one display surface can be controlled by GKS only by defining a separate workstation for each display surface. 4.5.2 Selecting a workstation The application program references a workstation by means of a workstation identifier. Connection to a particular workstation is established by the function OPEN WORKSTATION, which associates the workstation identifier with a workstation type and a connection ideptifier (for example, a unit number in FORTRAN). The current state of each open workstation is kept in a workstation state list. Segment manipulation and input can be performed on all open workstations. Output primitives are sent to, and segments are stored on, all active workstations and no others; an open workstation is made active by the function ACTIVATE WORKSTATION. An active workstation is made inactive by the function DEACTIVATE tion is closed by the function CLOSE WORKSTATION. The following sequence of functions illustrates workstation selection: OPEN WORKSTATION (Nl ,conidl ,workstation type A); OPEN WORKSTATION (N2,conid2,workstation type B); ACTIVATE WORKSTATION (Nl); Output functions; Input functions; ACTIVATE WORKSTATION Output functions; (N2); {generated on N 1,N2} {generated only on Nl {possible on Nl,N2} ) WORKSTATION; an open worksta-
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Output functions; Input functions;

{generated only on N2) {possible on Nl,N2}

CLOSE WORKSTATION (Nl); DEACTIVATE WORKSTATION CLOSE WORKSTATION (N2); 4.5.3 Deferring picture changes .

(N2);

It is desirable that the display of a workstation reflects, as far as possible, the actual state of the picture,as defined by the application program. However, to use the capabilities of a workstation efficiently, GKS allows a workstation to delay, for a certain period of time, the actions requested by the appli.cation program. During this period, the state of the display may be undefined. The function SET DEFERRAL STATE allows the application program to choose that deferral state which takes into account the capabilities of the workstation and the r+irements of the application program. Two attributes are defined for this purpose. Deferral mode controls the time at which output functions have their visual effects. Implicit regeneration controls the time at which picture changes have their visual effects: picture changes in general imply an' alteration not just an addition to the picture. The concept of deferral refers only to visible effects of GKS functions. the state of the workstation are (conceptually) not deferred. Effects on the segment storage or on

Deferral mode controls the possible delaying of output functions: for example, data sent to a device may be buffered to optimize data transfer. The values of deferral mode (in increasing order of delay) are: a) ASAP: The visual effect of each function will be achieved on the workstation As Soon As Possible (ASAP). GKS ensures that the actions necessary to achieve this visual effect are initiated before control is returned to the application program, but, owing to possible delays not under the influence of GKS, the actions are not necessarily completed before control is returned. The visual effect of each function will be achieved on the workstation Before the Next Interaction Globally (BNIG), i.e. before the next interaction with a logical input device gets underway on any workstation (see 4.8.2). If an interaction on any workstation is already underway, the visual effect will be achieved as soon as possible. The visual effect of each function will be achieved on the workstation Before the Next Interaction Locally (BNIL), i.e. before the next interaction with a logical input device gets underway on that workstation (see 4.8.2). If an interaction on that workstation is already underway, the visual effect will be achieved as soon as possible. The visual effect of each function will be achieved on the workstation Af Some Time (ASTI).

b)

BNIG:

c) BNIL:

d) ASTI:

Deferral applies to the following functions that generate output: POLYLINE POLYMARKER TEXT FILL AREA CELL ARRAY GENERALIZED DRAWING PRIMITIVE INSERT SEGMENT ASSOCIATE SEGMENT WITH WORKSTATION COPY SEGMENT TO WORKSTATION INTERPRET ITEM For none of the possible values of deferral mode is it mandatory
.
L

for an implementation

to delay the visual 33
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effect of output functions. If the application program requires a delay, it can achieve this using the segment storage facility and the visibility attribute. This restriction means that the buffer for deferred actions can be chosen in an implementation dependent manner. Certain functions can be performed immediately on some workstations, but on other workstations imply a regeneration of the whole picture to achieve their effect. For example, an implicit regeneration is necessary when picture changes require new paper to be put on a plotter. The entries `dynamic modification accepted' in the workstation description table indicate which changes e) lead to an implicit regeneration (IRG); I) can be performed immediately (IMM). If changes can be performed immediately, those changes may affect primitives outside segments in addition to those inside segments. If regeneration occurs, all primitives outside segments will be deleted from the display surface. An implicit regeneration is equivalent to an invocation of the function REDRAW ALL SEGMENTS. Its possible delay is controlled by the implicit regeneration mode, a single entry in the workstation state list. The values of implicit regeneration mode are g) SUPPRESSED: h) ALLOWED: Implicit regeneration of the picture is suppressed, until it is explicitly requested: the entry `new frame necessary at update' is set to YES. Implicit regeneration of the picture is allowed.

An implicit regeneration is made necessary, if any of the following occur: i) if the functions listed below have a visible effect on the display image of the respective workstation: 1) if the `dynamic modification accepted' entry in the workstation regeneration necessary) for the specified representation: SET SET SET SET SET SET POLYLINE REPRESENTATION POLYMARKER REPRESENTATION TEXT REPRESENTATION FILL AREA REPRESENTATION PATTERN REPRESENTATION COLOUR REPRESENTATION accepted', entry in the workstation WINDOW VIEWPORT description table is IRG for the description table is IRG (implicit

2) if the `dynamic modification workstation transformation: SET WORKSTATION SET WORKSTATION

3) if the `dynamic modification accepted' entry in the workstation description table is IRG for segment priority and this workstation supports segment priority: if primitives are added to open segment overlapping a segment of higher priority: POLY LINE POLYMARKER TEXT FILL AREA CELL ARRAY GENERALIZED DRAWING INSERT SEGMENT

PRIMITIVE

(since only segments have priority, primitives outside segments do not make an. implicit regeneration necessary.) if the complete execution of one of the following actions would be affected by segment priority:
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The Graphical Kernel System DELETE SEGMENT DELETE SEGMENT FROM WORKSTATION ASSOCIATE SEGMENT WITH WORKSTATION SET SEGMENT TRANSFORMATION SET VISIBILITY SET SEGMENT PRIORITY 4) if the `dynamic modification accepted' entry in the workstation description table is IRG for segment transformation: SET SEGMENT TRANSFORMATION 5) if the `dynamic modification accepted' entry in the workstation description table is IRG for `visibility (visible + invisible)`: SET VISIBILITY (INVISIBLE) 6) if the `dynamic modification accepted' entry in the workstation description table is IRG for `visibility (invisible + visible)`: SET VISIBILITY (VISIBLE) 7) if the `dynamic modification highlighting: SET HIGHLIGHTING 8) if the `dynamic modification accepted' entry in the workstation description table is IRG for delete segment: DELETE SEGMENT DELETE SEGMENT FROM WORKSTATION ITEM. accepted' entry in the workstation description table is IRG for Workst8tions

j) if any of the above situations occurs as a result of INTERPRET

An implicit regeneration has to be done (including deletion of primitives outside segments) only if one of the functions listed causes a visible effect on the display; for example, if an invisible segment is deleted, a regeneration need not be done. However, an implementation is allowed to perform an implicit regeneration in any of the cases listed above. Deferred actions can be made visible at any time by the use of the UPDATE WORKSTATION by an appropriate change of the deferral state. 4.5.4 Clearing the display surface Two capabilities for clearing the display surface are recognized, namely: a) clear the display surface even if it is empty; b) ensure that the display surface is clear without clearing the display surface needlessly. The second capability means that the display surface is only cleared when needed: this would normally be when the display surface is not clear, (i.e. when the `display surface empty' entry in the workstation state list is NOTEMPTY). The entry `display surface empty' in the workstation state list is set to NOTEMPTY if output is sent to the device. It may be set to NOTEMPTY even if output does not appear on the display surface (for example, a GDP primitive which has been clipped at the device, to non-existence). Both capabilities for clearing the display surface are available to the user through the function CLEAR WORKSTATION. The second capability is also used in UPDATE WORKSTATION and REDRAW ALL SEGMENTS ON WORKSTATION. 9 function or
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4.5.5 ElildarUoa

of primitives oataide segmem

..
situations:

Elimination of primitives outside segments occurs in the f&wing a) if the following GKS functions are-invoked: CLEAR WORKSTATION
: ,+$EDRAW

ALL SEGMENTS

ON WORKSTATION and if `new frame action necessary at update'

----tiPDATE WORKSTATION if the parameter update regeneration flag is PERFORM in the workstation state list is YES;

SET DEFERRAL STATE if `implicit regeneration mode' is ALLOWED and `new frame action necessary at update' is YES; b) if an implicit ALLOWED; regeneration is made necessary (see 4.5.3) and `implicit regeneration mode' is

c) if any of the above situations occurs as a result of INTERPRET 4.5.6 Sending mesaages to a workstation

ITEM.

The MESSAGE function allows a character string to be sent to a workstation.

The application program has no control over the position and, appearance of the character string and an implementation is allowed to place the string on a device distinct from, but associated with, the workstation. The rules to be followed by an implementation are stated in 5.2.
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4.6 Coordinate syeterm and traadortfiah
4.6.1 Normalization tradormatio~~

In GKS, the application programmer can compose his graphical picture from separate parts each of which, conceptually, is defined with its own world coordinate system (WC). The relative positioning of the separate parts is defined by having a single normalized device coordinate space (NDC) onto which all the .defined world coordinate systems are mapped. A set of normalization transformations define the mappings from the world coordinate systems onto the single normalized device coordinate space, which can be regarded as a workstation independent abstract viewing surface. This normalized picture can be stored and manipulated via the segment mechanism; it can also be stored on a metafile. For output, a single normalization transformation is current at any one time `and this is used to transform world coordinates specified, for example in output primitives and geometric attributes, into normalized device I coordinates. Anormalization transformation is specified by defining the limits of an area in the world coordinate system (window) which is to be mapped onto a specified area of the nofmalized device coordinate space~~icwport). Window and viewport limits specify rectangles parallel to the coordinate axes in WC and NDC. The rectangles include their boundaries. The normalization transformation performs a mapping from WC onto NDC' that includes translation and differential scaling with positive scale factors for the two axes. Although NDC space conceptually extends to infinity, the part of NIX space in which the viewport needs to be located and that can be viewed at a workstation is the closed range [OJ] x [O,l]. In addition, an implementation may support only a restricted range of NDCs. However, this range is always suIBciently greater than the [O,l]x [O,l] square that useful effects of INSERT SEGMENT can be achieved. In particular, NIX% `in the range [-7,7]x [-7.71are always handled. Each normalization transformation is identified by a transformation number which is an integer between 0 and an implementation dependent value n which can be inquired from the GKS state list. The normalization transformation with transformation number 0 is the unity transformation which maps [OJ] x [O,l] in world coordinates to [O,l]x [O,l] in normalized device coordinates. It cannot be changed. Initially, all other normalization transformations are set to a default transformation which is the same as transformation number 0. Different transformations can be specified at any time when GKS is open. Since GKS provides a number of different normalization transformations, it is possible for the application program to specify them prior to outputting the graphical picture. The separate parts of the picture are output by selecting a particular normalization transformation before outputting ,the associated graphical primitives. However, specifying a normalization transformation, while the graphical output is taking place, is allowed. A normalization transformation may be selected by SELECT NORMALIZATION TRANSFORMATION, and it will be used for all output until another is selected. By default, normalization transformation 0 is selected. 4.6.2 Clipping The viewport of a particular normalization transformation is used to define a clipping rectangle, as well as, with the window, specifying the normalization r;>nsformation. When the viewport of the current normalization transformation is set or when a normalization transformation is selected, the `clipping rectangle' entry in the GKS state list is set to the resulting viewport of the current normalization transformation. Clipping to this clipping rectangle can either be enabled or disabled. There is a single global switch (the clipping indicator) which defines whether or not the clipping rectangle is to be used for clipping, Clipping does not take place `when the normalization transformation is performed but is delayed until the output primitives are to be displayed on the display surface of a workstation. Output primitives stored in segments have their coordinates transformed to NDC and the associated clipping rectangle is stored with the primitives. The INSERT SEGMENT function allows the clipping rectangle in the GKS state list to replace the clipping rectangle. stored with an output primitive when the segment-was defined.
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Primitives sent to a workstation of category MO are not clipped. 4.6.3 Workstation transformations The normalized device coordinate space can be regarded as a workstation independent abstract viewing surface. Each open workstation can select independently some part of the NDC space in the range [O,l] x [O,l] to be displayed somewhere on the workstation display surface. A particular workstation transformation is a mapping from NDC space onto the device coordinates (DC) for that workstation. The units of device coordinates are metres on a device capable of producing a precisely scaled image (for example, on most plotters) and appropriate workstation dependent units otherwise (for example, on a display unit with unknown monitor size). In either case the device coordinate system maps onto the display space in the following way: a) the DC origin is at the bottom left corner of the display space; b) the device coordinate units are related to the display space in such a way that a square in device coordinates appears as a square on the display surface (this is trivially true if device coordinate units are metres); c) x and y increase to the right and upwards respectively. On some devices, device coordinate units do not coincide with addressable units, for example if the addressable units do not satisfy the above conditions. The size of the display space in device coordinate units is recorded in the workstation description table. The workstation transformation is a uniform mapping from NDC onto DC and thus performs translation and equal scaling with a positive scale factor for the two axes. Thus picture composition can be achieved using the normalization transformations whereas the workstation transformation allows different aspects of the composed picture to be viewed on different workstations. For example, a drawing could be output to a plotter at the correct scale and simultaneously some part of the drawing could be displayed on the full display surface of an interactive terminal. The workstation transformation can be specified at any time after the workstation has been opened. However, actually changing the workstation transformation may cause an implicit regeneration of the picture. A workstation transformation is specified by defining the limits of an area in the normalized device coordinate system within the range [O,l] x [O,l] (workstation window) which is to be mapped onto a specified area of the device coordinate space (workstation viewport). Workstation window and workstation viewport limits specify rectangles parallel to the coordinate axes in NDC and DC. The rectangles include their boundaries. To ensure that no output outside the workstation window is displayed, GKS clips at the workstation window boundaries, and this clipping cannot be disabled. As the workstation window is defined somewhere in the NDC range [O.l] x [O,l], this ensures that the only part of NDC space that can be viewed on any workstation lies in the range [O,l] x [OJ]. If the workstation window and workstation viewport have different aspect ratios, the scaling specified would be different on each axis if the workstation window was mapped onto the workstation viewport in its entirety. To ensure equal scaling on each axis, the workstation transformation maps the workstation window onto the largest rectangle that can fit within the workstation viewport such that: ,, d) aspect ratio is preserved; e) the lower left-hand comer of the workstation window is mapped to the lower left-hand comer of the workstation viewport. Thus, space is left unused at the top or right side of the workstation workstation window and workstation viewport are different. viewport if the aspect ratios of the

All workstation transformations are set by default to map NDC space [O,l] x[O,l] onto the whole of the workstation display space. If the display space is not square, the same rules as above apply to a&eve equal scaling on each axis.
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Workstation transformations can be changed by SET WORKSTATION WINDOW or SET WORKSTATION VIEWPORT. As a specification of the workstation transformation may be deferred (see 4.5.3), these two functions only set the `requested workstation window' and `requested workstation viewport' entries in the workstation state list. The `current workstation window' and `current workstation viewport' entries continue to hold the previously set transformation parameters. When the display is updated, the current values are set to the requested values. A complete data flow chart for graphical output is given in figure 9. It should be noted that all three coordinate systems (WC, NDC and DC) are two dimensional Cartesian coordinate systems. 4.6.4 Transformation of locator inpllt The application programmer,requires LOCATOR input to define a position in the most appropriate coordinate system currently defined by the set of normalization transformations. world

This is achieved by first transforming the input data from DC to NDC by the inverse .workstation transformation which is in effect when LOCATOR input is generated. LOCATOR input can only be obtained from positions within the part of the current workstation viewport into which the current workstation window is mapped (note that this is a subset of the workstation viewport whenever the aspect ratio of the workstation viewport and workstation window differ). Thus, LOCATOR input always defines a position in the NDC range [O,l] x [O,l]. To return to the application program a position in world coordinates, the position in NDC space' needs to be transformed from NDC to WC by the inverse of one of the normalization transformations. Each normalization transformation has associated with it a viewport input priority which is only relevant to LOCATOR and STROKE input. Normalization transformations are ordered in a list defined by the viewport input priority. At GKS initialisation, an implementation defined number of normalization transformations are initialised to have window and viewport set to the unit square and their viewport input priorities are set relative to the transformation number with transformation number 0 given the highest priority, transformation number I the next highest and so on. Changing the viewport input priority of any normalization transformation is allowed at any time. The LOCATOR input position in NDC space is compared with the viewports of the normalization transformations, to find the normalization transformation with the viewport which has the highest viewport input priority and contains the LOCATOR position. The LOCATOR position is transformed by the inverse of this normalization transformation to the associated WC. This LOCATOR position is returned to the application program in WC together with the number of the normalization transformation used. As transformation number 0 is the unity transformation with viewport [O,l] x [O,l] and cannot be changed, this ensures that LOCATOR input is always within at least one viewport. A data flow chart for LOCATOR input is given in figure 10. As transformatiqn number 0 is given the highest viewport input priority initially, LOCATOR input is effectively returned in WC equivalent to NDC until a normalization transformation is defined with a viewport input priority greater than that of transformation number 0. If a normalization transformation is no longer required for mapping LOCATOR input back to WC, it can effectively be hidden by reassigning it a viewport input priority lower thin transformation number 0. Changing the viewport input priority of transformation number 0 is allowed.

In an event report, generated by a LOCATOR device in EVENT mode, the DC position is transformed to the appropriate WC position before the event report is placed on the input queue. These transformations may be performed while the normalization and workstation transformations are being changed; thus, there is a race condition. The implementation has therefore to treat the transformations as resource: to be allocated and deallocated between the competing processes.

I
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Figure 10 - Data flow chart for locator input
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Between placing on the input queue and the execution of AWAIT EVENT which removes the LOCATOR position from the queue, it is possible for the normalization transformation and the workstation transformation to be changed by the application program. To ensure that the DC position located is equivalent to the WC position retrieved from the input queue, it is advisable for the application program not to change a transformation while a LOCATOR is in EVENT mode. 4.65 Transformation of stroke input Similar considerations apply to transformation of STROKE input as apply to LOCATOR input, with the complication that more than one point is involved. When each the inverse within the (analogous point of a stroke is generated, the coordinates of the point are transformed from DC to NDC by workstation transformation then in effect. STROKE input can only be obtained from positions part of the current workstation viewport into which the current workstation window is mapped to LOCATOR input). Thus STROKE input always consists of points in the NDC range

WI x to,r1.
To return to the appiication. program points in world coordinates, the points in NDC space need to be transformed from NDC to WC by the inverse of one of the normalization transformations. The STROKE points in NDC space are compared'with the viewports of the normalization transformations, to find the normali&on transformation with the viewport which has the highest viewport input priority and contains all of the points. The STROKE points are then transformed by the inverse of this normalization transformation and return& to the application program in WC together with the number of the normalization transforma, tion used. If the STROKE device is in SAMPLE mode, the normalization cessive samples. transformation used may vary between suc-

In EVENT mode, there is a similar race condition to that applying to LOCATOR input. Between placing an event report on the input queue and the execution of AWAIT EVENT which removes the STROKE event from the queue, it is possible for the normalization transformation and the workstation transformation to be changed by the application program. To ensure that the DC points input by the operator are equivalent to the WC points retrieved from the input queue, it is advisable for the application program not to change transformations while a STROKE device is in EVENT mode.

42

IS:12369-1987
IS0 7942
-

1985

The Graphical Kernel System 4.1 Segments 4.7.1 Introdudion to segments

Segments

In GKS, graphical output primitives may be grouped in segments as well as being created outside segments. Each segment is identified by a unique, application specified segment name. Segments may be a) transformed; b) made visible or invisible; c) highlighted; d) ordered front to back, which impacts overlapping primitives; e) made detectable or undetectable; f) deleted; g) renamed; h) inserted into the open segment or into the stream of primitives outside segments (see 4.7.6). Only primitives contained inside segments are affected by these operations. The application program has no access to primitives outside segments once they have been created. Every primitive within a segment has an attribute PICK IDENTIFIER which establishes a second level of naming. The sole function of the PICK IDENTIFIER is the identification of primitives; it cannot be used for manipulations. This level of naming is provided in GKS to reduce the segment overhead for applications where a great number of picture parts need to be distinguished for input but the need for manipulation is less important. Whereas segment names are unique, the same value for PICK IDENTIFIER can be assigned arbitrarily to single output primitives or groups of output primitives within segments, as illustrated in the following sequence of functions: SET PICK IDENTIFIER(4); CREATE SEGMENT (1); Output functious; SET PICK IDENTIFIER (2); Output functions; CLOSE SEGMENT; Output functions; SET PICK IDENTIFIER Output functions; (5); {primitives not pickable} {PICK IDENTIFIER = 5) {segment = 2, PICK IDENTIFIER {segment = 2,PICK IDENTIFIER = 5) = 3)

{segment = 1, PICK IDENTIFIER=4) {segment = I, PICK IDENTIFIER {primitives not pickable} (PICK IDENTIFIER = 2) = 2)

CREATE SEGMENT (2); Output functions; SET PICK IDENTIFIER (3); Output functions; CLOSE SEGMENT;

After a segment is closed, primitives in it cannot be modified nor can primitives be added to or deleted from the segment. No function is provided to extend a segment after it has been closed. Clipping rectangles and primitive attributes (geometric attributes, attributes controlling non-geometric aspects, and PICK IDENTIFIER) are stored along with primitives in segment storage. Geometrical transformations, changes of the segment attributes and changes of the workstation specific bundle and colour tables referenced from within a segment are possible. All values describing the state of a segment (i.e. name, segment attributes, and workstations active at creation time) are stored in a segment state list that GKS keeps during a segment's lifetime. Each segment is stored on all workstations active at the time the segment is created (CREATE SEGMENT). It can be deleted on all workstations by the DELETE SEGMENT function. It can be deleted on a specific workstation by the DELETE SEGMENT FROM WORKSTATION function. All segments stored on a 43
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specific workstation can be deleted from it by the CLEAR WORKSTATION

Segment storage on an OUTPUT or OUTIN workstation is referred to as Workstation Dependent Segment Storage (WDSS). GKS provides a second segment storage system for workstation independent storage of pictures at run time, Workstation Independent Segment Storage (WISS: see 4.7.5 and 4.7.6). Segments cannot be moved from WDSS to another workstation, but from WISS they can. Segments have a unique name across all segment storage. of available segment names (for example 32 000). 4.7.2 Segment attributes Segment attributes affect all the primitives in a segment. The segment attributes are: a) b) c) d) SEGMENT TRANSFORMATION: VISIBILITY: HIGHLIGHTING: SEGMENT PRIORITY: (see 4.7.3); a segment is either displayed or not; a visible segment is either highlighted or not; if parts of segments (for example, FILL AREA, CELL ARRAY) overlap, the segment with the higher priority will be preferred, both when the. segments are displayed and when they are picked; a segment can either be selected by a pick input device or it cannot. A GKS implementation provides a large number

e)

DETECTABILITY:

The segment attributes are unique for each segment and do not vary on different workstations. The default segment attributes (identity transformation, visible, not highlighted, priority 0, undetectable) are assigned to a segment when it is opened. The segment attributes of any segment in existence, including the open segment, may be ch.anged. The binding of segment attributes is shown in figure 2 (see 4.4). Segment priority affects segments being displayed (i.e. performing segment and workstation transformations, including clipping, for each primitive of the segment). If parts of primitives overlap with others of a visible segment with higher priority, these parts may be invisible. Whether a workstation supports this feature is indicated in the workstation description table. This feature is intended to address appropriate hardware capabilities only. It is not intended to mandate shielding on non-raster displays. When primitives within a segment overlap, the implementation determines the appearance of the overlapped parts. The actual effect is listed in the documentation accompanying an implementation. When primitiveS of segments overlapping each other are picked, the segment with higher priority is selected. When primitives of the same segment or of segments with equal priority overlap, the results are implementation dependent. 4.7.3 Segment tranaformatlous Segment transformations/are tion. Segment transformations a) segment name; b) transformation matrix. The transformation matrix is a 2 x 3 matrix, consisting of a 2 x 2 scaling and rotation portion and a 2 x 1 translation portion. Utility functions (EVALUATE TRANSFORMATION MATRIX, ACCUMULATE TRANSFORMATION MATRIX) are available to the application program for setting up the transformation matrices. A lixed point for scaling and rotation, and a shift vector in either WC or NDC may be specified. In the former case. the WC values of the fixed point and shift vector are first transformed using tlfe current normalization transformation. The segment transformation takes place after the normalization transformation, but before any clipping. a mapping from NDC onto-NDC. They perform translation, scaling and rota-

are characterized by:
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A segment transformation, specified by the SET SEGMENT TRANSFORMATION function, is not actually performed in the segment storage but only saved in the segment state list. Every time the segment is redrawn this segment transformation is applied before clipping. Successive SET SEGMENT TRANSFORMATION function calls for the same segment are not accumulated; each succeeding transformation matrix replaces its predecessor. By calling SET SEGMENT TRANSFORMATION with an identity transformation matrix, the original segment can be obtained without loss of information. Locator input data is not affected by any segment transformation. 4.7.4 Clipping and WDSS Clipping takes place after the normalization and segment transformations have been applied. Each primitive is clipped against the clipping rectangle associated with the primitive when it was put into the segment. If the `clipping indicator' entry in the GKS state list was CLIP when this occurred, the clipping rectangle associated with the primitive is the clipping rectangle in the GKS state list at that time, otherwise it is [O,l] x [O,l] in NDC. Clipping rectangles are not transformed by the segment transformation and thus clipping is always performed against a rectangle whose edges are parallel to the NDC space coordinate axes. 4.7.5 Workstation Independent Segment Storage One Workstation Independent Segment Storage (WISS) is defined, where segments can be stored for use by the COPY SEGMENT TO WORKSTATION, ASSOCIATE SEGMENT WITH WORKSTATION, and INSERT SEGMENT functions, as described in 4.7.6. None of these functions modify the contents of the segments to which they are applied. Only one WISS is permitted in a GKS implementation. The ability to manipulate segments requires the storage of all segments so that they can be reused on whatever workstations are active when they are created. By contrast, primitives outside segments cannot be reused. GKS does not define the manner and format of the storage of segments as long as all segment operations can be performed and as long as the correct clipping is applied to each primitive. The point in the viewing pipeline at which primitives are recorded in the WISS immediately follows the point at which data are distributed to workstations, as shown in figure 9 (see 4.6). For this reason the WISS is treated like a workstation (of category WISS), as far as control functions are concerned. Primitives are transformed from world uoordinates to NDC before they are distributed to workstations. Whether the WISS is realized within the GKS nucleus or by utilizing the capabilities of an appropriate cal workstation or other input/output device is left to the implementor. * 4.7.6 WISS functions and clipping Just as in other workstations, a segment is stored in WISS if WISS is active when the segment is created and a clipping rectangle is associated with each primitive. If the `clipping indicator' entry in the GKS state list is CLIP when this occurs, the cIipping rectangle associated with the primitive is the clipping rectangle in the GKS state list; otherwise it is [O,l] x [O,l] in NDC. COPY SEGMENT TO WORKSTATION copies primitives from a segment in WISS to be output on the specified workstation. The function takes a cop; of each primitive and its associated clipping rectangle from a segment in the WISS, transforms the primitives by the segment transformation and puts the clipping rectangles and the transformed primitives into the viewing pipeline at the place equivalent to the one where the information left (but it is sent only to the workstation specified in the invocation), as shown in figure 9 (see 4.6). This function cannot be invoked when a segment is open. By contrast with ASSOCIATE SEGMENT WITH WORKSTATION, this function does not cause a segment.10 exist on the specified workstation. ASSOCIATE SEGMENT WITH WORKSTATION copies the segment to the WDSS of the specified works tation in the same way as if the workstation were active when the segment was created. Clipping rectangles are copied unchanged. This function cannot be invoked when a segment is open. physi-
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`INSERT SEGMENT allows previously stored primitives (in segments in WISS) to be transformed and again placed into the stream of output primitives. INSERT SEGMENT reads the primitives from a segment in the WISS, applies the segment transformation followed by the insert transformation and then inserts them into the viewing pipeline at the point before data are distributed to the workstations. All clipping rectangles in the inserted segment are ignored. Each primitive processed is assigned a new clipping rectangle, which is the clipping rectangle in the GKS state list if the `clipping indicator' entry in the GKS state list is CLIP and is [O,l] x [O,l] if the `clipping indicator' entry in the GKS state list is NOCLIP. In other words, inserted primitives are assigned clipping rectangles in the same manner as directly created primitives. Thus, all primitives processed by a single invocation of INSERT SEGMENT receive the same clipping rectangle. Inserted information may re-enter the WISS, if the WISS is active and a segment is open. An invocation of INSERT SEGMENT has no effect on output primitives passing through the pipeline before or after the invocation. The INSERT SEGMENT function can be used when a segment is open but the open segment cannot, itself, be inserted.
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An application program obtains graphical input from an operator by controlling the activity of one or more logical input devices, which deliver logical input values to the program. A logical input device is identified by a workstation identifier, an input class and a device number. The workstation identifier identifies an open workstation, belonging to category INPUT or OUTIN, of which the logical input device is a part. The logical input device is implemented in terms of a physical input device or devices present on the workstation. The input class determines the type of logical input value that the logical input device delivers. The six input classes and the logical input values they provide are:

a) b)
cl

LOCATOR:

a position in world coordinates mation number.

and a normalization

transfor-

STROKE:

a sequence of points in world coordinates transformation number. a real number.

and a normalization

VALUATOR: CHOICE:

4 e) 0

a CHOICE status and a non-negative integer which represents a selection from a number of choices. a PICK status, a segment name and a pick identifier. outside segments cannot be picked. a character string. Primitives

PICK:

STRING:

The device number distinguishes different logical input devices of the same class on the same workstation. A workstation of category INPUT or OUTIN contains at least one logical input device. A GKS implementation providing at least one OUTIN workstation always provides an operator with at least one logical input device in each class defined at the level (see 4.10.3) of the implementation. Each logical input device can be operated in three modes. called operating modes. At any time a logical input device is in one, and only one, of the modes set by the invocation of a function in the group SET <input class > MODE. The three operating modes are REQUEST, SAMPLE and EVENT. Input from devices is obtained in different ways depending on the mode as follows.

g)

REQUEST:

A specific invocation of REQUEST <input class> causes an attempt to read a logical input value from a specified logical input device. This can only occur when the logical input device is in REQUEST mode. GKS waits until the input is entered by the operator or a break action is performed by the. operator. The break action is dependent on the logical input device and on the implementation. If a break occurs, the logical input value is not valid.

IS:12369-1987 lSO7942-1985 Graphical input h) SAMPLE: The Graphical Kernel System A specific invocation of SAMPLE <input class > causes GKS, without waiting for an operator action, to return the current logical input value of a specified logical input device. This can only occur when the logical input device is in SAMPLE mode. GKS maintains one input queue containing temporally ordered event reports. An event report contains the identification of a logical input device and a logical input value from that device. Event reports are generated asynchronously, by operator action only, from input devices in EVENT mode. The application program can remove the oldest event report from the queue and examine its contents. The application can also flush from the queue all event reports from a specified logical input device. A specific logical input device is said to be taking part in an interaction during the whole time tliat it is in SAMPLE or EVENT mode, but, when it is in REQUEST mode, only during the execution of a REQUEST <input class > function for that device. Alternatively, an interaction with the device may be said to be underway during that time. Many devices on many workstations may be taking part in interactions simultaneously. 4.8.2 Logical input device model To describe the precise actions of the logical input devices, it is first necessary to describe their relationship with physical input devices, using the concept of measures and triggers. A logical input device contains a measure, and a data record containing details about trigger are parts of the implementation of prompt and echo type, echo area, and data a trigger, an initial value, a prompt and echo type, an echo area the prompt and echo type. A logical input device's measure and the workstation containing the logical input device. Initial value, record can be supplied by the application program.

i)

EVENT:

The measure of a logical input device is a value determined by one or more physical input devices together with a `measure mapping'. More than one measure can simultaneously be determined by a single physical device; a separate measure mapping applies for each measure. A measure can be seen as the state of an independent, active process (a measure process). Each state corresponds exactly with a logical input value. The current state of the measure process (i.e. the device's measure) is available to GKS as a logical input value. Whenever the device is taking part in an interaction, the measure process is in existence. Under other conditions, `this process does not exist. When a measure process comes into existence, the data in the workstation state list entry for the logical input device are examined. The initial value is checked for legality according to input class dependent rules explained in 4.8.4. If the check succeeds, the initial value is used as the current state of the process; otherwise a value dependent on the logical input device is used. Next, a prompt is output to indicate that the device is ready for use. (The prompt technique used by a device is determined by its prompt and echo type, which may be selected by calling the appropriate INITIALISE function.) Creation of the measure process is then complete. While the measure process is in existence, if echoing measure process is provlded to the operator. is required, output indicating the current state of the

The trigge; of a logical input device is a physical input device or a set of them together with a `trigger mapping'. The operator can use a trigger to indicate significant moments in time. At these moments, the trigger is said to `fire'. A single operator action (for example, pressing a button or a light pen tip s\fitch) causes the firing of not more than one trigger. Several logical input devices can refer to the same trigger.
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A trigger can be seen as an independent, active process (a trigger process) that sends a message to one or more recipients when it fires. A logical input device is a recipient of its trigger if there is a pending REQUEST for it or if it is in EVENT mode. Both of these conditions can be true simultaneously for different logical input devices. If there is at least one recipient for a trigger, the trigger process is in existence. llJnder other conditions th& process dais not exist. If a REQUEST for a logical input device is pending when the device's trigger fires, the measure of that device is used to satisfy the REQIJEST. if one or more devices containing a given trigger are in EVENT mode when the trigger fires, the identifications of those devices and their measure values are passed to the input queue mechanism as separate event reports. The input queue mechanism is described in detail in 4.8.5. When a trigger firing succeeds in satisfying a REQUEST, or adding event records to the input queue, GKS provides to the operator an acknowledgement the form of which depends on the implementation of the logical input device. The acknowledgement is not controllable by a GKS function.

48.3

Operating mo&s of iogicai input devices SET <input class > MODE

The mode of a logical input device may be changed by invoking'the appropriate function.

After an invocation of SET <input class > MODE with the parameter REQUEST, no measure process exists for the specified device and the device's identifier is not on its trigger's list of recipients. After an invocation with the parameter EVENT, a newly initiated measure process is in existence for the specified device and the device's identifier is on its trigger's list of recipients. After an invocation with the parameter SAMPLE, a newly initiated measure process is in existence for the specified device, but the device's identifier is not on its trigger's list of recipients. Initially a logical input device is in REQUEST mode. While a device is in REQUEST mode, a logical input value may be obtained by invoking the appropriate REQUEST < device class > function. The effects of doing so are as follows. a) To create a measure process for the specified device and to set its value to the initial value from the workstation state list as described in 4.8.4. Echoing is performed by the measure process if echoing is on for the specified device. b) To add the device's identifier to its trigger's list of recipients. trigger process is started. If the list was previously empty, the

c) To suspend GKS until the trigger of the specified device iires, or the operator invokes the break facility. d) If the trigger fired, to set the logical input value to the current state of the measure process. e) To destroy the measure prooess. f) To remove the device's identifier from its trigger's list of recipients. trigger process is destroyed. If this list becomes empty, the

g) If the trigger fired, to return the logical input value and the status OK, &hex-wise to return the status NONE. While a logical input device is in SAMPLE mode, a logical input value may be obtained by invoking the appropriate SAMPLE <input class> function. The effect of doing so.is to set the logical input value to the current state of the measure process without waiting for a trigger firing. While a logical input device is in EVENT mode, logical input values are added as event reports to the input queue, and may be obtained in sequence by' invoking AWAIT EVENT, and then invoking the appropriate GET < device class > function. (More details of the input queue are given in 4.8.5.) . Figure 11 shows the effect of every operating mode on the measure and trigger of a logical input device.
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REQUEST mode

Single value returned to application program on trigger firing. Interaction lasts for single request.

measure

SAMPLE mode
SAMPLE

Trigger inoperative. Value returned for each call to SAMPLE. Multiple calls to SAMPLE in a single interaction.

I

measure

(Y&G--)

EVE.NT mode
AWAIT EVENT

Value and device identification sent to single queue on trigger firing and removed by a call to AWAIT EVENT.

Note:

4 --D

thick arrows represent thin arrows represent

flow of input data control

Figure 11 - The relationship between the measure and trigger for different operating modes, illustrated for a single logical input device
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Details of the measures of logical input devices of different classes are as follows. A LOCATOR measure consists of a position in world coordinates number. Let P and N denote these values. and a normalization transformation

Then P transformed to NDC by N lies within the workstation window. Also P lies within the `window specified by N and, in addition, P transformed to NDC by N lies outside all viewports of higher priority than N. A STROKE measure consists of a sequence of points in world coordinates and a normalization tion number. Let Pl....P, be the points and N be the transformation number. transforma-

Then P; (1 <i <m) transformed to NDC by N lie within the workstation window. Also Pi (1 li <m) lie within the window specified by N and, in addition, there is no viewport of higher priority than N containing all the points Pi transformed to NDC by N. Thus, N may change as points are added to the stroke. Any invocation of SET WINDOW, SET VIEWPORT or SET VIEWPORT INPUT PRIORITY can cause a change in P (any Pi for STROKE) or N or both, but the above conditions hold for the new values. The rules impl; that no normalization transformation having priority less than that of transformation 0 can appear in the state of a LOCATOR or STROKE measure, process (with the default settings of the viewport input pridrities, normalization transformation 0 has the highest). A VALUATOR measure provides logical input values that are real numbers. Each value lies between (possibly including) minimum and maximum values, which are in the data record in the workstation state list. . A CHOICE measure provides logical input values whose components are OK or NOCHOICE and an integer in the range 1 to a device dependent maximum specified in the workstation description table. If the first component is OK, then the integer is valid. CHOICE input typically occurs when an operator presses a button (the numeric identifier of the button determines the measurg) or combination of buttons (the measure is derived from the combination of buttons pressed). A PICK measure provides logical input values whose components are OK or NOPICK. segment name and a pick identifier. If the first component is OK, then the segment name and pick identifier obey the following rules: a) The segment exists and has VISIBILITY on and DETECTABILITY on. b) The segment is present on the workstation containing the PICK device. c) The pick identifier is ;he pick identifier attribute of at least one output primitive in the segment. This is tested using the clipping parameters in effect when the primitive arrived at the workstation. Part of the primitive lies within the workstation window and, if clipping was on, part also lies within the primitive's (normalization) clipping rectangle. Further, the primitive is not completely overlapped by primitives in a segment of higher priority. The PICK initial value is tested against the above rules whenever the PICK measure process is initiated. If the rules are not satisfied, the process state is set to NOPICK. For certain workstations, testing rule c) when the PICK measure process is initiated, may be very expensive. In such cases. only rules a) and b) need be tested. The PICK measure is defined using the properties of output primitives and segments. only on workstations of category OUTIN. PICK devices exist

A STRING measure provides logical input values which are character strings up to a device dependent maximum length specified by the buffer size value in the data record in the workstation state list.
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Input queue und current event report

The input queue contains zero or more event reports. Event reports contain pairs of values (device identifier, logical input value) resuliing from trigger firings. Event reports can be added to the input queue when logical input devices in EVENT mode are triggered by the operator. Events can be removed from the input queue by invocations of AWAIT EVENT, FLCTSH DEVICE EVENTS and CLOSE WORKSTATION. When a trigger that is part of one QT more logical input devices in EVENT mode fires, the resulting event reports are entered into the queue and marked as a group of simultaneous event reports. An event report for each device is added to the input queue, if and only if there is room for the whole group of simultaneous event reports. The order of reports within a group of simultaneous event reports is undefined. If tlizre is not room in the queue for all event reports when a trigger fires. input queue overflow has occurred. Input queue overflow is not reported to the application program immediately. It is reported via the error mechanism during the next invocation of any GKS function that ca.n remove event reports from the input queue (PIWAIT EVENT', FLUSH DEVICE EVENTS, and CLOSE WORKSTATION). The input queue has ICY be emptied before further event reports will be added. Betwien the detectlon of input queue overflow and the rs+xt lime AWAIT EVENT is invoked with the input queue empty, no events are generated by trigger i;r-ingc and thus no ackAzowledgements are provided. (This permits the application program to determine how many events were in the queue when overflow occurred by calling AWAIT EVENT with zero timeout.) When the "input queue overflow' error is reported, the trigger causing the overflow is indicated by placing m:o the error state list the identification of any one of the logical input devices using that trigger which was in EVENT mode at the time the overflow was detected. A%`.LZITEVENT, if the queue is not empty, removes the first event report after copying the logical input value into the current event report in the GKS state list. The workstation identifier, input class and device number are refurntid to the application program directly by AWAIT EVENT. If the queue is empty, AWAIT EVENT suspends execution until an event rep&t is queued or until the specified timeout period has l elapsed. The a;,plication program may obtain the contents of the current event report by calling the appropriate < input class > function. GET

If, after removing the event report there remain in the queue other reports in the same group of simultaneous events as the remo%cd report, the `more simultaneous events' entry in the GKS state list is set to MORE. Otherwise it is set to NOMORE. FLUSH DEVICE EVENTS removes all event reports for a specific device from the input queue. CLOSE WORKSTATION removes from the input queue all event reports for all logical input devices on that workstaYin:i. If the `more simultaneous events' entry has the value MORE, when either FLUSH DEVICE EVENTS or CLOSE WORKSTATION is invoked, and they remove all the remaining reports in the group of simultaneous event reports at the head of the queue, then the entry is set to NOMORE. 4.8.6 Initialisatioa,
of input devices

For each input class, there is an INITIALISE function which can only be called if the logical input device it specifies is i,p REQIJEST mode. These functions provide the following information to a device via the workstation state list (if the INITIALISE function is not called. then default values apply): a) An initial value appropriate to the class. If the initial value violates the rules, an error occurs and the workstation state list is unchanged. 9
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b) A prompt and echo type that selects the prompting technique and, if echoing is on, the echoing technique for a logical input device. An implementation dependent prompt and echo type (type 1) is required for all logical input devices. Further prompt and echo types appropriate to each class are defined but not required. These further types are listed with the appropriate INITIALISE function. Prompt and echo types above those are reserved for registration (see 4.1.2). Prompt and echo types less than 0 are device dependent. c) An echo area (xmin,xmax,ymin,ymax) in device coordinates. Input device implementations echo area for certain prompt and echo types to display prompts or echoes. may use the

d) A data record. Some input classes have mandatory control values in the data record. Some prompt and echo types within an input class also have mandatory control values in the data record. These values occupy well defined places in the data record. In any data record used in initialising an input device, values mandatory to the input class, if any, appear first followed by values mandatory to the prompt and echo type if any. Depending on the device and prompt and echo type, the data record may contain other (additional) information. When a logical input device is REQUESTed, or when it is set to EVENT or SAMPLE mode, its measure is set to the initial value from the workstation state list, unless this is not a valid measure for the device. If it is not a valid measure for the device, the measure is set to a devioe dependent value, except for PICK devices, for which the measure is set to NOPICK. Prompt and echo types describe both the prompt, which informs the operator that the device is available, and the echo, which informs the operator of the state of the measure. The functions provided to control input device mode, SET <input class> MODE, also control whether echo is on or off. In addition, an implementation dependent acknowledgement of successful trigger firings is provided. The items in data records mandatory for each class are: in a STROKE data record, input buffer size in number of points; in a VALUATOR data record, low value and high value; in a STRING data record, input buffer size and initial cursor position. Prompt and echo types which have mandatory values are types 2, 3, 4 and 5 for CHOICE.
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4.9 GKS Metafile interface For the purpose of long-term filing of graphical information; called GKS Metafiles (GKSMs). They can be used for: a) transporting graphical information b) transporting tapes); graphical information between systems; from one place to another (for example, by means of magnetic GKS provides an interface to sequential ties

c) transporting graphical information from one GKS application to another; d) storing accompanying non-graphical information. The GKSMs behave like workstations. For output and input, several different workstations of the categories MO and MI can be used concurrently. However, some workstation control and inquiry functions are not applicable to these workstations (they are not meaningful). Clause A.5 of annex A gives a complete listing of all GKS functions which affect `workstations of category MO and MI. The application program Fay write data in a metafile using WRITE ITEM TO GKSM. MO workstation the metafile may be opened as an MI workstation. After closing an

Three functions, GET ITEM TYPE FROM GKSM, READ ITEM FROM GKSM and INTERPRET ITEM are provided to read and interpret metafiles. These functions absume that a metafile consists of a sequence of items. Each item comprises an item type, an item data record length and an item data record. The item type indicates either that the item contains information that can be interpreted by GKS or that it contains infor-. mation thai was written by an application program (using WRITE ITEM TO GKSM). When an MI workstation is opened, the first item in the metafile becomes the `current item'. GET ITEM FROM GKSM delivers the item type and item data record length of the current item. READ ITEM FROM GKSM copies the contents of the item data record of the current item into a data area supplied by the application program and then makes the next item in the metafile the current item. INTERPRET ITEM takes the contents of a GKSM item data record supplied by the application program (as delivered by READ ITEM FROM GKSM) and causes appropriate changes in the set of GKS state variables and generates appropriate graphical output as determined by the metafile specification. The information in metafile item data records can be regarded as falling into classes corresponding to the classes of GKS functions. The interpretation of primitive attribute, clipping rectangle or clipping indicator information causes appropriate changes to entries in the GKS state list. The geometric primitive attribute information, which is expressed in NDC, is transformed by the inverse of the currently selected normalization transformation before being used to set the appropriate entries in the GKS state list. Information corresponding to GKS functions which control a single workstation, but where a workstation is not specified, may be interpreted on all active workstations. The specification of the format and content of a metafile is not part of this standard. format which is sufli&ent for GKS purposes. Annex E describes a

In order to preserve consistency of the file contents, the GKSM may be written and read only under GKS control. Figure 12 shows the relationship between the application program, GKS, and the GKSM.
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.
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Figure 12 - Relstiodp between GKS ml GKSM
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GKS levels 4. IO GKS levels 3. IO.I Introduction to levels The GKS system is designed to be motion and real time interaction. In require considerable implementation implementations that do not include 4.10.2 The level structure capabilities (minimal (no input, of GKS can be grouped into the major areas:

usable by a wide range of applications, from static plotting to dynamic addition, many display devices lack features (such as picking) that would It is therefore desirable to permit GKS effort to simulate with software. all of the functional capabilities defined in this International Standard.

The functional a) output b) input c) number d) attributes

performance, REQUEST

full performance); input, full input); multiple workstations); attribute specifications Independent possible, full bundle Storage), concept); full seg-

of workstations

(one workstation, bundles

(only predefined (none,

and individual (without

e) segmentation mentation).

basic segmentation

Workstation

Segment

lf an arbitrary combination of capabilities were to be considered a valid GKS implementation, an almost unlimited number of different standard dialects would result and program portability, one of the major goals of this International Standard, would not be achieved. Therefore, nine valid levels of the GKS system are delined, in order to address the most common classes of equipment and applications. Each GKS implementation provides precisely the functions of one level. A GKS implementation is invalid if it lies between two defined levels. The level structure The output has two independent axes: input and `all the other functions', summarized as output.

level axis has the three possibilities: output: with full output; Segment Storage.

0: Minimal

1: Basic segmentation 2: Workstation

Independent

The input level axis has the three possibilities: a: No input;' b: c: REQUEST Full input. are expressed by functions and by ranges of parameters. input;

In GKS. capabilities

There are three different

types of capability

at each level: capability. Every GKS implementation at a specific level supports may support the capability

f) An explicitly defined and required the capability at thal level.

g) An explicitly defined and non-required capability. A GKS implementation and, if it does, it is implemented according to the explicit function definitions.

h) A conceptually defined and non-required capability. A GKS implementation may provide the capability. Its implementation follows general rules given by the GKS concepts and functional definitions. The set of explicitly i) predefined j) linetypes k) marker defined and required numbers capabilities includes: minimum;

bundle 1 to 4;

up to the required

types 1 to 5; STRQKE (output levels 1 and 2);

1) text precision
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m) interior style HOLLOW; n) one input device for each input class defined at that level (input levels b and c); o) prompt and echo type 1 (input levels b and c). The set of explicitly defined and non-required capabilities includes: p) text precision STROKE (output level 0); q) interior style SOLID, PATTERN, r) transformable patterns; s) segment priority (output levels 1 and 2); t) prompt and echo types above 1 that are defined (input levels b and c). The set of conceptually defined and non-required capabilities includes: u) linetypes above 4; v) marker types above 5; w) specific generalized drawing primitives; x) prompt and echo types above the defined set (input levels b and c); y) specific escape functions. Explicitly defined and non-required capabilities of a specific level can become explicitly defined and required capabilities in a higher level of GKS, through variations in the ranges of parameters, for example text precision STROKE and metafile workstations. Each GKS level contains precisely those functions that are explicitly defined and required in that level. However. ranges of parameters may contain additional explicitly defined and non-required capabilities and conceptually defined and non-required capabilities. 4.10.3 Level functionality
~

HATCH;

The facilities making up each of the components of a level are as follows: a) Output level 0: Minimal output 1) basic control; 2) all primitives available at least in minima1 performance; 3) use of predefined,bundles 4) colour representation only (no modification to bundles); modification possible;

5) only one workstation with output capabilities available at a time; 6) metafile workstations not required; if provided, then both input and output are available; if not provided, then metafile functions return appropriate errors; 7) multiple normalization transformations one settable normalization transformation 8) suitable basic inquiries; 9) pixel readback provided (non-pixel devices may report non-processing). (but a system with normalization is allowable); transformation 0 and only
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b) Output level I: Basic segmentation with full output I) all output level 0 capabilities; 2) full workstation control; 3) full output features; 4) full bundle concept; 5) multiple workstation concept; 6) metafile workstations required;
7) multiple settable normalization

transformations; Independent Segment Storage);

8) basic segmentatioa (no Workstation 9) suitable inquiries. c) Output level 2: Workstation 2) Workstation

Independent Segment Storage

I) all output level 1 capabilities; Independent Segment Storage.

d) Input level a: No input I) no iacilities. e) Input level b: REQUEST input I) input device initialisation and mode setting functions; 2) REQUEST functions on all appropriate devices; 3) appropriate logical input devices include PICK if and only if combined with output level I capabilities; 4) function to set viewport input priority.
r) input

,

level c: Full input

I) all input level b capabilities; 2) SAMPLE and EVENT mode input. Table 1 gives a summary of th$ functionality of each valid GKS level. Each box contains only those functions added to the previous boxes of the same row and column.
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GKS levels Table 1 - GKS level7 concept

.
Level

8
No input, minimal control, only predefined bundles, multiple normalization transformation facilities but minimum settable required is I, and all output functions; metafile workstations optional Full output including full bundle workstation multiple basic except segmentation Workstation Storage);

IapmtLevel
b REQUEST input, mode setting and initial& functions for logical input devices, no PICK, and set viewport input priority
C

I

SAMPLE and EVENT input, no PICK.

concept,

REQUEST PICK, mode setting and iditialise for PICK

GGGam
PICK

concept, (everything Independent

Segment

metafile workstations required Workstation ment Storage. Independent Seg-

Embedded in the levels summarized above are variations in the number of possibilities required in the set of explicitly defined and required capabilities. Table 2 exactly identifies the minimum support which is always provided at each level.

,

.
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Tbe Grqbied Table 2 - Minimum support required at each level
Level

Kernel System

ZAPABILITY Foreground colours (intensity) Linetypes Lit&widths Predefined polyline bundles kttabk polyline bundles Huker types Marker sizea Predettned polymarker bundles Iettabk polymarker bundles Character heights (see note I) Character expansion factors (see note I) Ptring-precision fonts Character precision fonts Stroke precision fonts Prede6ned text bundles gettable text bundles P&e&d patterns (see note 2) Settabk patterns (see notes 2 and 5) Hatch styles (see note 3) Predetined fill area bundles Settable fill area bundles Scttable normalization transformations Segment priorities (see note 4) Input classes Prompt and echo types per device Length of input queue (see note 5) Maximum string buffer size (characters) Maximum stroke btdfer size (porn@ Workstations of category OUTPUT or OUTIN Workstations of category INPUT or OUTIN Workstation Independent Segment Storage MO workstations

Oa

Ob

Oc I 4 I 5 5 I 5 I I I I 0 2 I

la

lb I 4 I 5 20 5 I 5 20 I

Ic I 4

2a I 4 I 5 20 5 I 5 20 I

2b I 4

2c

I
4

I
4 I 5 5 I 5 _ I I I I 0 2 _ I

I
4 I 5 20 5 I 5 20 I

I
4 I 5 20 5 I 5 20 I

I
5 _ 5 1 5 _ I

I
5 20 5 I 5 20 I

1
5 20 5 I 5 20 I

I
I I 0 2 _ I

I
I I 2 6 20 I IO 3 5 IO IO 2 `-6464

I
`I I 2 6 20 I IO 3 5 IO 10 2 6 I 72

I
I I 2 6 20 I 10 3 5 IO 10 2 6 I 20 72

I
I I 2 6 20 I IO 3 5 IO IO 2 -6464

1
I I 2 6 20 I IO 3 5 IO IO 2 6 I 72

1
I I 2 6 20 I IO 3 5 IO IO 2 6 I 20 72

.
3 5 _

3 5 I 5 I

3 5 -

I
_

I
5 I 20 72 I l 0 0

.
I 0 0 -6464

72 I I 0 0

I
I I

I
l I I

I
l I I

1
1 I I

I
l l

I
l l

I
I

I
I

MI workstations

0 indicates explicitly detined and non-required at that level - indicates not defined at that level NOTES Rekvant only for character and string precision text. Relevant only for workstation supporting pattern interior style. Relevant only. for workstation supporting hatch interior style. Rekvant only for workstation supporting segment priorities. Since availabk resources are finite and entries have variable size. it may not always be possible to achieve the minimum values in a particular application.
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GKS exists in one of five different operating states (see figure 13):
GKCL = GKS closed; GKOP = GKS open;

WSOP = At least one workstation open; WSAC = At least om workstation active; SGOP = Segment open.

GK$
closed

I

GKS

I
attribute settiJu

open close

-At least one

workstation open
I A

activate first workstation activate n.st. (

t At least one

rc deactivate last workstation

workstation active

create

close segment ty c

prim22

generation attribute setting input /

Figure 13 - Same trrrrpitiom betweeo operating stata~

t
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The operating state value is contained in a global static variable that is initialised, before the first invocation of GKS, to the value GKCL. The operating states dilier in so far as individual calls to GKS are allowed only in certain operating states, as indicated in the functional description in clause 5. The overall state of GKS is defined by a set of state variables having specific values. These state variables are characterized by the fact that they allow a complete description of the effects of the' functions. The total set of GKS state variables contains the following subsets: a) operating state; b) GKS state list; c) segment state list for every existing segment; d) input queue; ' e) workstation state list for every open workstation;

9 GKS error state list.
Certain functions cause these state subsets to be allocated, made available and cancelled. When these state subsets are allocated, they are initialised with default values. When initialising a workstation state list, some of the default values are taken from the workstation description table for that workstation type. There is a workstation description table for each workstation type supported by the GKS implementation. The variables * of the state subsets are modified and inquired by invocations of GKS functions.
..._

When an error condition is detected during execution of a GKS function, GKS calls the ERROR HANDLING procedure. During execution of the ERROR HANDLING procedure, GKS is in an error state. In this error state, GKS allows only inquiry functions, the ERROR LOGGING procedure and the EMERGENCY CLOSE GKS procedure to be executed and no modifications to any of the state lists except the error state list. 4.11.2 IDQuiry fsmedoos Inquiry functions return values directly from or derived from the various state lists and workstation description tables. The data types of the values and the default values of the entries are summarized in clause 6. The inquiry functions of GKS are designed in such a way that they do not cause any errors to be generated. Inquiry functions for values that may be logically unavailable have an output parameter, `error indicator', that determines whether or not the other returned values are valid. The availability parameter is of type integer and, in the event of the other values not being available, returns an error number, which identifies the appropriate GKS error condition. The same error numbers are used as for non-inquiry functions and thus the standard list of error messages should be consulted. If GKS is not in the proper state, then the error number appropriate to this condition is the one returned, even if there are other reasons for the values being unavailable. If the values are available, zero is returned in the error indicator parameter. For all values except zero the returned output values are implementation dependent. inquiry function lisp the error indicator values that. the function can return. The description of each
_

Some inquiry functions that retrieve values from the workstation state lists have an input parameter of type . `enumeration' that can take the following values : a) SET: b) REALIZED: the values returned are those provided by the application program; the values returned are those used by the workstation mapped to the available values in the workstation. when the actual values .are
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4.12 Error handling
For each GKS function, a finite number of error situations is specified, any of which will cause the ERROR HANDLING procedure to be called. Every GKS implementation supports this error checking. The ERROR HANDLING procedure provides an interface between GKS and the application program. The ERROR HANDLING procedure, if provided by the application program, may interpret the information about the error and may store data-in a data area for subsequent interpretation by the application program after return from the GKS function that caused the error. The GKS error handling strategy is derived from the following classification of errors: I errors resulting in a .precisely defined reaction; II errors resulting in an attempt to savt'the results of previous operations; III errors which cause unpredictable results including the loss of information. GKS recognizes three situations in which errors are detected: A error detected in GKS procedures; B error detected in procedures called from GKS (driver procedures, operating system procedures); C error detected in other areas of the application program. If errors are detected outside GKS (situation C), either the application program may regain control over the execution or program execution will be terminated abnormally. In the latter case, results are unpredictable (class III), and in the worst situation, all graphical information produced so far in this job may be lost. If, however, the application program obtains control, it may attempt to close GKS properly or at least attempt an emergency closure by calling the EMERGENCY, CLOSE GKS procedure. Similarly, if the error occurs in procedures called by GKS and control is not returned Properly to GKS, the effects are unpredictable. The EMERGENCY CLOSE GKS procedure is an implementation dependent facility. Its purpose is to save as much of the graphical information produced as possible. The effects of this procedure on the workstations are left undefined in this International Standard. The EMERGENCY CLOSE GKS procedure may be called directly from the application program. It is also called from GKS itself as a standard error reaction to class II errors. . Finally, all errors that are listed explicitly as part of the definition of GKS functions belong to class I. Either they are detected within GKS itself (situation A) or a procedure called from GKS has returned control, to the corresponding GKS procedure, with the appropriate error information (situation B). In all these class I cases, GKS calls the ERROR HANDLING procedure. If a GKS function is called with more than one error condition applicable, at least one error is reported. The application program may either provide its own ERROR HANDLING procedure or may use that-provided as part of GKS. Any ERROR HANDLING procedure accepts the following information from GKS: a) the identification of the error condition; b) the identification `of the GKS function that called the ERROR HANDLING
c) the error file. . /

5

procedure; procedure, using

The ERROR HANDLING the same set of parameters.

procedure provided by GKS just calls the ERROR LOGGING The latter performs the following actions:
a

d) prints an error message and GKS function identification on the error file; *e) returns to the calling procedure. This two-stage calling of the error procedures allows the application program to supply its own ERROR HANDLING procedure, while still having access to services provided by the ERROR LOGGING procedure, as shown in the following example of; an application program supplied ERROR HANDLING procedure.
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PROCEDURE ERROR HANDiJNG in order lo s&t * folbwii 0asb3:

(error mmhr.

identifkalion of GKS function. nor

file);

Interpret GKS function and eclw identification CASE `special treaunent': Interpret error parameters as

parsed from.GKS;
data area;

Store information for application program in application suppiii Return io calling GKS procedure; CASE `standard trcatmcnt':

Call ERROR LOGGING procedure with all the above pammeters; Return to calling GKS procedure; END.

All GKS proctehres petform the Fotlowing actions after detecting an error condition: f) set error state to OhJ; * g) call ERROR HANDLING procedure with appropriate parameters; h) set error state to OFF; i) Perform built-in error reaction (normally, a function causing an error has no effect; to accomplish this in some cases requires clean-up operations). All GKS procedures check on entry (in the folbnving order): j) that GKS is in the correct state; k) that the values of input parameters are valid.' At least the first error detected is repor&d except that, in the case of mquiry functions, the first error detected is returned via the error indicator. The application program supplied ERROR HANDLING procedure has access to the set of GKS state variables. However, no modification of GKS state is possible during error handling, i.e. only GKS inquiry functions, the ERROR LOGGING procadure and the EMERGENCY CLOSE GKS procedure may be called by the application program supplied ER,ROR HANDLING procedure. This is achieved by setting the error state to ON prior to calling the ERROR HANDLING procedure from GKS and setting the error state to OFF afterwards. An inquiry ~functioncannot generate an error.
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A uniform escapk mechanism for allowing access to installation and hardware specific features (a `standard way of being non-standard') is provided by means o$ the ESCAPE function. Although the use of this mechanism reduces the portability of the application program, it does so in an easily identifiable manner. The ESCAPE function does not generate geometrical output; by contrast, tlw GENERALIZED DRAWING PRIMITIVE can generate geometrical output not otherwise generated by GKS.
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5 GKS functions

5.1 Notational conventions The heading of each function specifies a) the function's name; b) the GKS states in which the function may be used except that, for inquiry functions (see X9), only those states in which the inquiry function can return valid values is specified; c) the GKS lowest level L at which the function is explicitly defined and required. More information about levels and states can be found in 4.10 and 4.11 respectively. Clauses A.3 and A.4 of annex A contain lists of all functions according to levels and states respectively. The GKS functional capabilities are summarized in annex G. The parameter Hsts indicate for each entry e) the name of the parameter; f) for coordinate data, the coordinate tems are explained in 4.6); 0 system (WC, NDC, DC) used in the function call (coordinate sys_ d) whether the entry is an input (In) or output (Out) parameter;

g) either, for enumeration type data, the permitted values, or, for real and integer data, any restriction on their value range (for example, ` > 0'): the notation is explained in 6.1; h) the data type, which is either of simple form (I, R, S, P, N, E) representing: I R S P N E integer real string t point name enumeration type
#

or is a compound based on one or more of the simple forms (for example: n x P) or is a compound, the content and structure of which are not delined in this International Standard: D
e

data record

The data types are explained in 6.1.

/
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5.2 Control functions
OPEN GKS Parameters: In In error file amount of memory units for buffer alrea N I GKCL L0a

Effect: GKS is set into the operating state GKOP = `GKS open'. The GKS state list is allocated and initialised as indicated in 6.4. The GKS description table and the workstation description tables are made available. The entry `error file' in the GlKS error state list is set to the value specified by the first parameter. The permitted buffer area which can be used by GKS for internal purposes is limited.
NOTE - Certain environments might not permi't dynamic memory management. In this case, the buffer area may be limited in a static way to be described in the installation documentation.

References: 4.11 4.12 Errors: I GKS not in proper state: GKS shall be in the state GKCL 200 S$ecified error file is invalid

CLOSE GKS Parameters: none

GKOP

L0a

Effect: GKS is set into the operating state GKCL = `GKS closed'. .The GKS description table, GKS state list and the workstation description tables become unavailable. All GKS buliers are released and all GKS files are closed.
NOTE - GKS can be reopened by invoking the function OPEN GKS.

References: 4.11 4.12 Errors: 2 GKS not in proper state: GKS shall be in the state GKOP

OPEN WORKSTATION Parameters: In In In workstation identifier connection identifier workstation type

GKOP,WSOP,WSAC,SCOP

LOa
N N N

Effect: If GKS is in operating state GKOP, it is set into the state WSOP = `at least one workstation open'. GKS requests the operating system to establish the speci'fied connection for a workstation characterized in the workstation description table by the `workstation type'. The workstation state list is allocated and initialised a:; indicated in 6.5. The workstation identifier is added to the se; of open workstations in the GKS sta'te list.
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OPEN WORKSTATION lessly.
NOTE

GKS functiorw ensures that the display surface is clear, but does not clear the surface need-

The connection identifier is given in a form suitable for the application program language (for example, a `unit number' in
FORTRAN or a `file identifier' in PL/I). An attempt to open a workstation, with the same connection identifier and workstation type as one elrcady open, causes error 26 to occur.

References: 4.5.2 4.11 Errors: 8 20 21 22 23 24 _ 26 28 42

GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP Specified workstation identifier is invalid Spectjied connection identtjier is invalid Specijed workstation type is invalid Specased workstation type does not exist Specilfed workstation is open Specified workstation cannot be opened Workstation Independent Segment Storage is already open Maximum number of simultaneously open workstations would be exceeded

CLOSE WORKSTATION Parameters: In workstation identifier

WSOP,WSAC,SCOP

Lo1 N

Effect: An implicit UPDATE WORKSTATION (with the parameter update regeneration tIag set to PERThe workstation state list is &allocated. The FORM) is performed for the specified workstation. workstation identifier is deleted from the set of open workstation8 in tkc GKS state list and from the set of associated workstations in the segment state list of every segment containing it. If the set of associated workstations of a segment becomes empty, the segment is d&ted. The input queue is flushed of all events from all devices on the workstation being closed. If the `identification of one of the logical input devices that cau)ad an input queue ovei-tIow' entry in the GKS error state list refers to this workstation identifier, tha all the contents of that entry become undefined. The connection to the workstatio& is released. GKS is set into operating state GKOP if no workstais tions remain open. The display surface need not be cleared when CLOSE WORKSTATION invoked, but it may be cleared. References: 4.5.2 4.8.5 4.11 Errors: 7 20 25 29 147

GKS not in proper_state: GKS shall be in one of the states WSOP, WSAC or .SGOP Specified workstation identifser is invalid Spec@ed workstation is not opeu S)ectj%?d workstation is active Input queue has overflowed

IS : 12369 - 1987 180 7942 - 1985
GKS functions ACTIVATE WORKSTATION Parameters: In workstation identifier N Effect: GKS is set into the operating state WSAC = `At least one workstation active'. The specified workstation is marked active in the workstation state list. The workstation identifier is added to the set of active vbbrkstations in the GKS state list.
NOTE - Output primitives are sent to and segments are stored on all active workstations.

controi flmclions

WSOP,WSAC

L4ta

References: 4.5.2 4.11 Errors: 6 20 25 29 33 35 43
,

GKS not in proper state: GKS shall be either in the state WSOP or in the state WSAC Specified workstation identifjer is invalid Spectjied workstation is not open Specified workstation is active Spectfied workstation is of category MI Specified workstation is of category INPUT Maximum number of simultaneously active workstations would be exceeded

DEACTIVATE WORKSTATION Parameters: In workstation identifier

WSAC

Loa N

Effect: The specified workstation is marked inactive in the workstation state list. The workstation identifier is deleted from the set of active workstations in the GKS state list. GKS is set into the operating state WSOP = `At least one workstation open' if no workstation remains active.
NOTE - Whik a workstation is inactive, primitives are not sent to it nor does it store new segments. Segments already stored on this workstation are retained.

References: 4.5.2 4.11 Errors: 3 20 30 33 35

GKS not Specified Specified Specified Speci$ed

in proper state: GKS shall be in the state WSAC workstation identt$er is invalid workstation is not active workstation is of category MI workstation is of category INPUT

CLEAR WORKSTATION Parameters: In In workstation identifier control flag

WSOP,WSAC

LOa N E

(CONDITIONALLY,

ALWAYS)

Effect: All of the following actions are executed in the given sequence: a) All deferred actions for the specified workstation are executed (without intermediate clearing of l the display surface).

IS :12359-1997 1~07942-1985
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b) The display surface is set to a clear state according to the control flag as follows: CONDITIONALLY: the display surface is cleared only if the `display surface empty' entry in the workstation state list is NOTEMPTY. ALWAYS: the display surface is cleared. c) If the `workstation transformation update state' entry in the workstation state list is PENDING, the `current workstation window' and `current workstation viewport' entries in the workstation state list are assigned the values of the `requested workstation window' and `requested workstation viewport' entries; the `workstation transformation update state' entry is set to NOTPENDING. d) For *all segments stored on the specified workstation, the workstation identifier is deleted from the `set of associated workstations' in the segment state list. If the `set of associated workstations' of a segment becomes `empty', the segment is deleted. The `set of stored segments for this workstation' in the workstation state list is set to `empty'. e) The `new frame action necessary at update' entry in the workstation state list is set to NO. f) The `display surface empty' entry in the workstation state list is set to EMPTY. References: 45.3 4.5.4 45.5 4.7.1 Errors: 6 GKS not in proper state: GKS shall be either in the state WSOP or in the state WSAC
20 25 33 35 Specified SpeciJied Specified Specified workstation workstation workstation workstation identifier is invalid is not open is of category MI is of category INPUT

REDRAW ALL SEGMENTS

ON WORKSTATION

WSOP,WSAC,SGOP

Lla

Parameters: In Elect: workstation identifier All of the following actions are executed in the given sequence: a) All deferred actions for the specified workstation are executed (without intermediate clearing of the display surface). b) The display surface is cleared only if the `display surface empty' entry in the workstation state list is NOTEMPTY. The entry is set to EMPTY. c) If the `workstation transformation update state' entry in the workstation state list is PENDINC. the `current workstation window' and `current workstation viewport' entries in the workstation state list are assigned the values of the `requested workstation window' and `requested workstation viewport' entries; the `workstation transformation update state' entry is set to NOTPENDING. d) All visible segments stored, for this workstation (i.e. contained in the `set of stored segments for this workstation' in the workstation state list) are redisplayed. This action typically causes the `display surface empty' entry in the workstation state list to be set to NOTEMPTY. e) The `new frame action necessary at update` entry in the workstation state list is set,to NO. N
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GKS not Spectjied Spmifipd Spo?c$ed Specdjed Specified

in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP workstation identifier is invalid workstation is not open workstation is of category MI workstation is of category INPUT workstation is Worksl'ation Independent Segment Storage

UPDATE WORKSTATION Parameters: In In workstation identifier update regeneration flag

WSOP,WSAC,SGOP

LQa N E

(PERFORM,POSTPONE)

Effect: All deferred actions for the specified workstation are executed (without intermediate clearing of the display surface). If the update regeneration flag is set to PERFORM and the `new frame action necessary at update' entry in the workstation state list is YES, then the following actions are executed in the given sequence: a) The display surface is cleared only if the display surface empty' entry in the workstation state list is NOTEMPTY. The entry is set to EMPTY. b) If the `workstation transformation update state' entry in the workstation state list is PENDING, the `current workstation window' and `current workstation viewport' entries in the workstation state list are assigned the values of the `requested workstation window' and `requested workstation viewport' entries; the *workstation transformation update state' entry is set to NOTPENDING. c) All visible segments stored on this workstation (i.e. contained in the `set of stored segments for this workstation' in the workstation state list) are redisplayed. This action typically causes the `display surface empty' entry in the workstation state list to be set to NOTEMPTY. d) The `new frame action necessary at update' entry in the workstation state list is set to NO.
NOTE -

If the

update regeneration

flag is PERFORM, to the following

UPDATE

WORKSTATION

suspends

the effect of SET DEFERRAL

STATE.

In that case. it is equivalent INQUIRE

sequence of functions: AND UPDATE STATES;

WORKSTATION STATE

DEFERRAL

save deferral state; SET DEFERRAL (ASAP,ALLOWED): set deferral state to saved value; If the value UPDATE necessary REDRAW of the `new frame action necessary at update' entry is NO or the update of blocked regeneration flag is POSTPONE.

WORKSTATION al update' is YES

merely initiates and

the transmission regeneration

data. If the value of the entry `new frame action UPDATE WORKSTATION behaves as

the update

Rag is PERFORM,

ALL SEGMENTS

Oti'WORKSTATION. at update' entry in a workstation state list is set to YES during deferred action generation if

The `new frame action necessary both of the following

are true (see 4.5):

\

a) an action causing modification of the picture is actually deferred on that workstation;
h) the workstation example. display surface does not allow modification of the image without redrawing the whole picture (for plotter. storage Me display).
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GKS not Specified Specified SpecQied Spec$ed Spec#ed

in proper state: GKS shall be in one of the states WSOP. WSAC or SGOP workstation ident#er is invalid workstation is not open workstation is of category MI workstation is of category INPUT workstation is Workstation Independent Segment Storage

SET DEFERRAL STATE Parameters: In In In workstation identifier deferral mode implicit regeneration mode

WSOP,WSAC,SGOP

Llr

(ASAP,BNIG,BNIL,ASTI) (SUPPRESSED,ALLOWED)

N E E in be is to

I

Effect: The entries `deferral mode' and `implicit regeneration mode' for the specified workstation are set the workstation state list. Depending on the new value of `deferral mode', deferred output may unblocked. If in the workstation state list, the new value of `implicit regeneration mode' ALLOWED and `new frame action necessary at update' is YES, then an action equivalent REDRAW ALL SEGMENTS is performed. References: 4.5.3 4.5.5 Errors: 7 20 25 33 35 36

GKS not in proper state: GKS shall be in one of the states WJOP, WSAC or SGOP SpecijCed workstation ia%nt@er is invalid Specified workstation is not open Specljied workstation is of category MI Specified'workstation is of category INPUT Speczjied workstation is Workstation Independent Segment Storage

MESSAGE Parameters: In In workstation identifier message

WSOP,WSAC,SGOP

Llr N S

Effect: The message function: a) may display a message at an implementation dependent location on the workstation viewport or on some separate device associated with the workstation. b) does not alter the GKS state list. c) may affect the workstation in a purely local way (for example, requesting the oper or to change paper). Possible effects on the execution of the application program or on subseque r?t t commands sent to the workstation by GKS are stated explicitly in the implementation dependencies manual.

72

IS :12369 -1987
IS0 7942 (- 1985
GKS functions_ References: 4.5.6 Errors: 7 20 25 36
\ Control fmclions

GKS not Specified Specified Spectfied

in proper state: GKS shall be in one of the states WSOP. WSAC or SGOP workstation identifier is invalid workstation is not open workstation is Workstation Independent Segment Storage

2

ESCAPE Parameters: In In out specific escape function identification escape input data record escape output data record

GKOP,WSOP,WSAC,SGOP

L4h N D D

Effect: The specified non-standard specific escape function is invoked. The form of the escape data records and which of them are used may vary for different functions. Also the GKS states allowing `the invocation of a specifk escape furiction may be restricted. The following rules govern the definition of a new specific escape function: a) the GKS design concept (see clause 0) is not violated; b) the GKS state lists are not altered; c) the function does not generate geometrical output; d) any side effects arc well documented. Specific escape functions may apply to more than one workstation, for example all open workstations or all active workstations. The escape input data record can include a workstation identifier where this is required.
NOTE Examples of specific escape functions anticipated at present are: a) support of raster device8 allowing the dioplay of more than ohe frame buffer; b) uoe of ruterop hardware to manipulate data previously output by cell array. Where the specific escape function identikation is bound to an integer in a programming language, specific escape function

identifications greater than 0 are rmerved for registration and specigc escape function identifications less than 0 are impkmentation dependent. Specific escape function ideutikationr arc registered in the IS0 International Register of Graphical Items, which is maintained by the Registration Authority (me 4.1.2). When a specific escape function haa been approved by ISO, the specific escape function identification will be amignd by the Regirtration Authority.

References: 4.13

Et-rot-s:
8 180 I81 182 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP is not supported Spec$ed escape function identification is invalid Contents of escape data record are invalid
Specified escape faction
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5.3 output functions POLY LINE ' Parameters: Ill In number of points points (2.J.l) WC nxP I WSAC,SCOP L4h

Effect: A sequence of connected straight lines is generated, stM.ing from the first point and ending at the last point. The current values of the polyline attributes, as given by the GKS state list (see 6.4), are bound to the primitive. The polyline attributes are listed in 4.4.2. If, after the workstation transformation, thing is drawn is workstation dependent. References: 4:4.1 4.4.2 4.4.3 4.5.3
.

all points coincide, no error is generated and whether any-

Errors: 5 GKS not in proper state: GKS shall be either in the state WSAC or in the state SGOP 100 Number of points is invalid

POLYMARKER Parameters: In In number of points points

WSAC,SGOP (l..n) WC

LOa I nxP

Effect: A sequence of markers is generated to identify all the given positions. The current values of the poly marker attributes, as given by the GKS state list (see 6.4), are bound to the primitive. The polymarker attributes are listed in 4.4.2.
NOTE - A marker is visible if and only if the marker position is within the clipping rcctangk. The clipping of partially visibk is workstation dependent.

markers

References: 4.4.1 4.4.2 4.4.4 4.5.3 Errors: 5 GKS not in proper state: GKS shall be either in the state WSAC or in the state SGOP 100 Number of points is invalid
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ortrtfretiors
WSAC,SCOP Lo1 P S

TEXT Parameters: In In text position character string

WC

Effect: A character string is generated. The current values of the text attributes, as given by the GKS state list (see 6.4), are bound to the primitive. The text attributes are listed in 4.4.2. The text position is given in WC and transformed by the current normalization transformation. If, after the workstation transformation, the height or width of a character is zero, no error is generated and whether anything is drawn is workstation dependent. If the character string contains a control character (for example, characters outside the range 2/O to 7/14 inclusive in IS0 646), the effect is workstation dependent. Either error 101 is generated or some visual effect may be generated or the character may be ignored. Even if error 101 occurs, the character string is displayed on all active workstations which do not generate error 101.
NOTE - Text is clipped in a way that depends on the text precision as defined by the text font and precision currently s&c&d (either via the text bundle or individually, depending upon the corresponding ASF).

References: 4.4.1 4.4.2 4.4.5 4.5.3 Errors: 5 GKS not in proper state: GKS shall be either in the state WSAC or in the state SGOP 101 Invalid code in string

FILL AREA Parameters: In In number of points points

WSAC,SGOP (3..n) WC

Llh I nxP

Effect: A FILL AREA primitive is generated. The current values of the fill area attributes, as given by the GKS state list (see 6.4), are bound to the primitive. The @l area attributes are listed in 4.4.2. The polygon defined by the points is filled according to the fIl1 area interior style currently selected (either via the flll area bundle or individually, depending upon the corresponding ASF). The boundary is drawn for interior style HOLLOW, whereas, for other interior styles, the amount of the boundary that is drawn ensures that two regions which share a common edge appear without an apparent gap or overlap at that edge, to the extent that can reasonably be achieved. If parts of the area are clipped, the resulting new boundaries become part of the area boundaries. Multiple subareas may be generated (see figure 14). The interior of a polygon is defined in the following way (see figure 15). For a given point, create a straight line starting at that point and going to infinity. If the number of intersections between the straight line and the polygon is odd, the point is within the polygon; otherwise it is outside. If the straight line passes a polygon vertex tangentially, the intersection count is not affected. If a point is within the polygon, it is included inthe area to be filled subject to the rule for boundaries. If, after the workstation transformation, all points coincide, no error is generated and whether anything is drawn is workstation dependent. If, after the workstation transformation, some or all lines in a bounding polygon have a line segment in common, no error is generated. Whether the resulting line segment is regarded as part of the boundary to be drawn or not is workstation depend+
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GKS functions be picked by with interior Pointing at a interior style

For PICK input, a FILL AREA primitive displayed with interior style HOLLOW may pointing at any point on the bounding polygon. A FILL AREA primitive displayed style SOLID or PATTERN may be picked by pointing at any point inside the polygon. hole in the area does not identify that area. A FILL AREA primitive displayed with HATCH may be picked by pointing at any point on any hatch line.

WINDOW
resulting AREASafter clipping at the WINDOW

XF:

points

added to polygon

Figure 14 - Examples of FILL AREA clipping

Pi1
N:

points

to be

tested count

intersection

Figore 15 - Area hide a polygon References: 4.4.1 4.4.2 4.4.6 4.s.3 Errors: 5 GKS not in proper state: GKS shall be either in the state WSAC or in the state SGOP 100 Number of points is invalid
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CKS functions CELL ARRAY Parameters: In In In cell rectangle (P,Q) dimensions of colour index array DX,DY colour index array `WC ir 2xP (l..n) 2x1 (O..n) n x n x I output functiom WSAC,SGOP LOa

Effect: A CELL ARRAY primitive is generated using the cell rectangle comers, the dimensions of the colour index array and the colour index array. A rectangle, which is taken to be aligned with the world coordinate axes, is defined by the points P and Q. This rectangle is conceptually divided into a grid in DX x DY cells. Each cell has a width of IPX-QXI/DX and a height of IPY-QYI/DY, where (PX,PY) are the coordinates of the comerpoint P and (QX,QY) are the coordinates of the comerpoint Q. The colour index array is oriented with respect to the rectangle by associating the four corners as follows: the (1,l) element is associated with the cell having P at one comer; the (DX,DY) element with the cell having Q at one comer; the (1,DY) element with the cell having the point (PX,QY) at one comer; the (DX,l) element with the cell having the point (QX,PY) at one comer. The colour of each cell is specified by the index of the corresponding element of the colour index array. If an index is not present in the colour table on a workstation, a workstation dependent index is used on that workstation. The rectangular grid defined by P,Q,DX and DY is subject to all transformations, potentially transforming the rectangular cells into parallelograms. If part of a transformed cell is outside the window, the transformed cell is partially clipped.

CELLARRAY DX x DY CELLS

TRANSFORMED CELLARRAY

PIXELLOCATIONS ON DISPLAY SURFACE

NOTE - Cells are mapped on display surface. If display location is within cell then cell colour is assigned to pixel.

Figure 16 - Mapping of CELL ARRAYS

Mapping the transformed following rules:

cells onto the pixbis of a raster display (see figure 16) is performed by the defined by the transformed rectangle,

a) If the centrepoint of a pixel lies inside the parallelogram its colour is set.
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b) The pixel is assigned the colour of the cell which contains the pixel's centrepoint. Thus, the pixel colour is selected by point sampling the transformed rectangle at the pixel centrepoint, not by area sampling or filtering. The minimal simulation required is to draw the transformed implementation dependent colour, linewidth and linetype. boundaries of the cell rectangle, using

If, after the workstation transformation, the four comer points are coincident or collinear, no error is generated and whether anything is drawn is workstation dependent. References: 4.4.1 4.4.2 4.4.7 4.5.3 Errors: 5 GKS not in proper state: GKS shall be either in the state WSAC or in the state SGOP 91 Dimensions of colour array are invalid

GENERALIZED DRAWING PRIMITIVE (GDP)

WSAC,SCOP (O..n)
I WC

IAla I nxP N D

Parameters:, In In In In number of points points GDP identifier GDP data record

Effect: A Generalized Drawing Primitive (GDP) of the type indicated by the GDP identifier is generated on the basis of the given points and the GDP data record. The current values of the entries in the GKS state list (see 6.4) for the sets of polyline, polymarker, text or fill area attributes are bound to the primitive. These attributes are listed in 4.4.2. When the GDP generates output at the workstation, zero or more of the sets of attributes are used. These are the sets of attributes most appropriate for the specified GDP function and are selected for the GDP as part of the definition of the GDP. (They are defined in the workstation description table.)
NOTE - The parameters are transmitted to the workstation and interpreted in a workstation dependent way. In this way special capabilities of the workstation can be addressed. Even if error 104 or error 105 occurs, the GDP is displayed on all active workstations capable df doing so. For example, some of the primitives anticipated at present are: a) circle: points given are centre, peripheral point; b) circular arc: points given are centre, start point, end point to be connected anticlockwise in world coordinates; c) ellipse: points given are 2 focal points, peripheral point; d) elliptic aq> points given are 2 focal points, start point, end point to be connected anticlockwise in world coordinates: e) interpolating curve (for example, spline): points given are interpolated. The recommended set of attributes to use for the above GDP examples would be the polyline attributes It should be emphasized that the points, specified as parameters, are trausformed by GKS after the interpretation of the points (as defining, say, a spline curve or circle) is performed by the active workstations. For example, a GDP, which defines a circle, would appear as an ellipse when the transformation has differential scaling for the two axes. Each specific GDP definition defines how the transformation is applied to both the points and the shape of the GDP. Though the points cannot be clipped, the resulting output of the GDP is clipped against the clipping rectangle. if the `clipping indicator' entry in the GKS slate list is CL.IP, and the workstation window. If a specific GDP is available on a workstation but is unable to be generated because the current transformations or clipping rectangle are such that the preceding conditions would be violated, error 105 occurs. The GDP data record attribute list may contain additional data for each point (for example, vertex order ffr splines) which remain untransformed. These have to be defined for a specific GDP. In defining a new GDP, the GKS design concepts (see clause 0) are not violated. The set of generalized drawing primitives implemented on a workstation may be empty.

1$:12369-1987 IS0 7942 - 1985
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Where the GDP identifier is bound to an integer in a programming language, GDP identifiers greater than 0 are reserved for registration and GDP identifiers less than 0 are implementation dependent. GDP identifiers are registered in the IS0 International Register of Graphical Items, which is maintained by the Registration Authority (see 4.1.2). When a GDP has been approved by ISO, the GDP identifier will be assigned by the Registration Authority.

References: 4.4.1 4.4.2 4.4.8 4.5.3 4.13 Errors: 5 100 102 103 104 105

GKS not in proper state: GKS shall be either in the state WSAC or in the state SGOP Number of points is invalid Generalized drawing primitive identifier is invalid Content of generalized drawing primitive data record is invalid At least one active workstation is not able to generate the specified generalized drawing primitive At least one active workstation is not able to generate the specified generalized drawing primitive under the current transformations and cli,oping rectangle
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5.4 Output attributes
5.4.1 Workstation independent primitive attrihtes SET POLYLINE Parameters: In polyline index (1.n) I Effect: The `current polyline index' entry in the GKS state list is set to the value specified by the parameter. This value is used when creating subsequent POLYLINE output primitives. References: 4.4.2 4.4.3 Errors: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP
60 Poljline index is invalid

INDEX

GKOP,WSOP,WSAC,SGOP

LOa

SET LINETY PE Parameters: In linetype

GKOP,WSOP,WSAC,SGOP (-n..-l,l..n)
j

LOa
I

Effect: The `current linetype' entry in the GKS state list is set to the value specified by the parameter. This value is used for the display of subsequent POLYLINE output primitives, created when the `current linetype ASF' entry in the GKS state list is INDIVIDUAL. This value does not affect the display of subsequent POLYLINE output primitives, created when the `current linetype ASF' entry in the GKS state list is BUNDLED. Linetype values produce linetypes as indicated: <o 1 2 3 4 25 implementation dependent solid line dashed line dotted line dashed-dotted line reserved for registration

If the specified linetype is not available on a workstation, linetype 1 is used on that workstation.
NOTE - Linetype valr\es are registered in the IS0 International Register of Graphical Items, which is maintained by the Registration Authority (see 4.1.2). When a linetype has been approved by ISO, the iinetype value will be asSigned by the Registration Authority.

References: 4.4.2 4.4.3 Errors: 8 GKS not in proper state: GKS shall be in one qf the states GKOP, WSOP, WSAC or SGOP
63 Linetype is equal to zero
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GKS functions SET LINEWIDTH Parameters: In linewidth scale factor 20 R Effect: The `current linewidth scale factor' entry in the GKS state list is set to the value specified by the parameter. This value is used for the display of subsequent POLYLINE output primitives, created when the `current linewidth scale factor ASF' entry in the GKS state list is INDIVIDUAL. This value does not affect the display of subsequent POLYLINE output primitives, created when the `current linewidth scale factor ASF' entry in the GKS state list is BUNDLED. The linewidth scale factor is applied to the nominal linewidth on a workstation; by the workstation to the nearest available linewidth. References: 4.4.2 4.4.3 Errors: 8 GKS not in proper state: GKS shall be in one of the States GKOP, WSOP, WSAC or SGOP 65 Linewidth scale factor is less than zero the result is mapped SCALE FACTOR Output attributes GKOP,WSOP,WSAC,SGOP LOa

SET POLYLINE Parameters: In

COLOUR INDEX

GKOP,WSOP,WSAC,SGOP (O..n)

LOa I

polyline colour index

Effect: The `cumnt polyline colour index' entry in the GKS state list is set to the value specified by the param+%er. This value is used for the display of subsequent POLYLINE output primitives, created when the `current polyline colour index ASF' entry in the GKS state list is INDIVIDUAL. This value &es not affect the display of subsequent POLYLINE output primitives, created when the 6cu&n$polyline colour index ASF' entry in the GKS state list is BUNDLED. The colour index is a pointer into the colour tables of the workstations. If the specified colour index is not present in a workstation colour table, a workstation dependent colour index is used on that workstation. References: 4.4.2 `4.4.3 Errors: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP 92 Colour index is less than zero

SET POLYMARKER Parameters: In

INDEX

GKO&WSOP,WSAC,SGOP (l..n)

LOa I

polymarker index

Effect: The `current polymarker index' entry in the GKS state list is set to the value specified by the parameter. This value is used when creating subsequent POLYMARKER output primitives, References: 4.4.2 4.4.4
t

9
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Output attributes GKS functions

Errors: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP. WSAC or SGOP 66 Polymarker index is invalid

SET MARKER TYPE Parameters: In marker type

GKOP,WSOP,WSAC,SGOP (-il..-1,l.n)

L&a I

Effect: The `current marker type' entry in the GKS state list is set to the value specified by the parameter. This value is used for the display of subsequent POLYMARKER output primitives, created when the `current marker type ASF' entry in the GKS state list is INDIVIDUAL. This value does not affect the display of subsequent POLYMARKER output primitives, created when the `current marker type ASF' entry in the GKS state list is BUNDLED. `Marker type values produce centred symbols as indicated: <o 1 2 3 4 5 26 implementation + * 0 x reserved for registration dependent

Marker type 1 is always displayed as the smallest displayable dot. If the specified marker type is not available on a workstation, marker type 3 (*) is used on that workstation.
NOTE - Marker type vale arc registered in the IS0 Intimational Rcgiktcr of Graphical Items, which is maintained by the Rcgistration Authority (ace 4.1.2). When a marker type has been approved by ISO, the marker-type value will be assigned by the Registration Authority.

References: 4.4.2 4.4.4 Errors:` 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP 69 Marker type is equal to zero

SET MARKER SIZE SCALE FACTOR Parameters: In marker size scale factor

GKOP,WSOP,WSAC,SGOP 20

Loa R

Effect: The `current marker size scale factor' entry in the GKS state list is set to the value specified by the output primitives, parameter. This value is used for the display of subsequent POLYMARKER created when the `current marker size scale factor ASF' entry in the GKS state list is INDIVIDUAL. This value does not affect the display of subsequent POLYMARKER output primitives, created when the `current marker size scale factor ASE' entry in the GKS state list is BUNDLED. The marker size scale factor lisapplied to the nominal marker size on a workstation; mapped by the workstation to the nearest available marker size. References: 4.4.2 4.4.4 t the result is

82

IS: 12369 - 1987 IS0 7942 - 1985 GKS functions output attributes

Errors: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC: or SGOP 71 Marker size scale factor is less than zero

SET POLYMARKER COLOUR INDEX Parameters: In polymarker colour index

GKOP,WSOP,WSAC,SGOP
(O..n)

Loa I

Effect: The `current polymarker colour index' entry in the GKS state list is set to the value specified by the parameter. This value is used for the display of subsequent POLY$MARKER output primitives, created when the `current polymarker colour index ASF' entry in the GKS state list is INDIVIDUAL. This value does not affect the display of subsequent POLYMARKER output primitives, created when the `current polymarker colour index ASF' entry in the GKS state list is BUNDLED. The colour index is a pointer into the colour tables of the workstations. If the specified colour index is not present in a worLstation colour table, a workstation dependent colour index is used on that workstation. References: 4.4.2 4.4.4 , Errors: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP 92 Colour index is less than zero

SET TEXT INDEX Parameters: In text index

GKOP,WSOP,WSAC,S<P (1.J.r)

LOa I

Effect: The `current text index' entry in the GKS state list is set to the value specified by the parameter. This value is used when creating subsequent TEXT output primitives. References: 4.4.2 4.4.5 Errors: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP 72 Text index is invalid

SET TEXT FONT AND PRECISION Parameters: In text font and precision

- GKOP,WSOP,WSAC,SGOP

Loll (I;E)

(-n..-l,l..n;STRING,CHAR,STROKE)

Effect: The `current text font and precision' entry in the GKS state list is set .to the value specified by the parameter. This value is used for the display of subsequent TEXT output primitives, created when the `current text font and precision ASF' entry in the GKS state list is INDIVIDUAL. This value does not affect the display of subsequent TEXT output primitives, created when the `current text font and precision ASF' entry in the GKS state list is BUNDLED.
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ISO 7942 - 1985
Output attributes
GKSfWlCthS

Text font and precision is a single text aspect; a particular text font can be available at some, but not necessarily all, precisions. Text font 1 contains a graphical representation of the characters defined in IS0 646 (see 4.4.5). Text fonts greater than 1 are reserved for registration. Text fonts less than 0 are implementation dependent. The text precision value determines the fidelity with which the other text aspects are used. The values of text precision, in order of increasing fidelity, are STRING, CHAR and STROKE (see 4.4.5). If the specified text font and precision is not available on a workstation, used on that workstation. the value (1;STRING) is

NOTE - Text font numbers are registered in the IS0 International Register of Graphical Items, which is maiataaincd by the Registration Authority (see 4.1.2). Wheo a text font has been approved by ISO. the text font number will be assigned by the Registration Authority.

References: 4.4.2 4.4.5 Errors: 8 GKS not in proper state: GKS shall be in one of the states GKO?, WSOP, WSAC or SGOP 7.5 Text font is equal to zero

SET CHARACTER EXPANSION FACTOR Parameters: In character expansion factor

GKOP,WSOP,WSAC,SGOP >o

LQa R

Effect: The `current character expansion factor' entry in the GKS state list is set to the value specified by the parameter. This value is used for the display of subsequent TEXT output primitives, created when the `current character expansion factor ASF' entry in the GKS state list is INDIVIDUAL. This value does not affect the display of subsequent TEXT output primitives, created when the `current character expansion factor ASF' entry in the GKS state list is BUNDLED. References: 4.4.2 4.4.5
:, Errors: 8 GKS not in proper state: GKS shali be in one of the states GKOP, WSOP, WSAC or SGOP 77 Character expansion factor is less than or equal to zero

SET CHARAdTER SPACING Parameters: In E&Z
'

I GKOP,WSOP,WSAC,SGOP

LOa R

character spacing

The `current character spacing' entry in the GKS state list is set to the value specified by the parameter. This value is used for the display of subsequent TEXT output primitives, created when the `current character spacing ASF' entry in the GKS state list is INDIVIDUAL. This value does not affect the display of subsequent TEXT output primitives, created when the `currknt chard&r spacing :I ASF' entry in the GKS state list is BUNDLED. 9

References: 4.4.2 4.4.5
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Errors:, 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP

GKOP,WSOP;WSAC,SCOP LOa SET TEXT COLOUR INDEX Parameters: (0.n) ( I In text colour index Effect: The `current text colour index' entry in the GKS state list is set to the value specified by the parameter. This value is used for the display of subsequent TEXT output primitives, created when the `current text colour index ASP' entry in the GKS state list is INDIVIDUAL. This value does not affect the display of subsequent TEXT output primitives, created when the `current text colour index ASP' entry in the GKS state list is BUNDLED. The colour index is a pointer into the colour tables of the workstations. If the specified colour index is not present in a workstation colour table, a workstation dependent colour index is used on that workstation. References: 4.42 4.4.5 Errors: 8 GKS not in proper state: GKS shall be in one of the states GKOP. WSOP. WSAC or SGOP
92 Colour index is less than zero

.

SET CHARACTER HEIGHT GKQP,WSOP,WSAC,SGOP uh Parameters: R In character height >O WC Effect: The <currentcharacter height' entry in thu GKS state list is set to the value specified by the parameter. The `current character width' entry in the GKS state list is also set to the value specified by the parameter. These values are used when creating subsequent TEXT output primitives. References:
4.4.2 4.4.5

Errors: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP
78 Character height is less than or equal to zero

SET CHARACTER UP VECTOR GKOP,WSOP,WSAC,SGOP LOa Parameters: In character up vector WC 2xR Effect: The `current character up vector' entry in the GKS state list is set to the value specified by the parameter. The `current character base vector' entry in the GKS state list is set to a vector, of arbitrary length, at right angles in the clockwise direction to the value specified by the parameter. These values 9 are used when creating subsequent TEXT output primitives.

IS : 12369 - 1987
IS0 7942 - 1985 Output attributes References: 44.2 4.4.5 Errors: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP. WSAC 79 Length of character up vector is zero
it

GKS functions

SGOP

SET TEXT PATH Parameters: In text path
.

GKOP,WSOP,WSAC,SCOP (RIGHT,LEFT,UP,DOWN)

Ma E This -

Effect: The `current text path' entry in the GKS state list is set to the value specifkd by the parameter. value is used when creating subsequent TEXT output primitives.
NOTE - A change in the value of `current text path' may make the value of !he `current text alignment' entry ibappropriate.

References: 4.4.2 4.4.5

.

_j Errors: `8 GKS not in proper state: GKS shall be in one of the states GKOP, WiYOP, WSAC or SGOP

SET TEXT ALIGNMENT Parameters: In

GKOP,WSOP,WSAC,SCOP

LOa

text alignment (NORMAL,LEFT,CENTRE,RIGHT;NORMAL,TOP,CAP,HALF,BASE,BOTTOM)

2xE

Effect: The `current text alignment* entry in the GKS state list is set to the value specified by the parameter. This value is used when creating subsequent TEXT output primitives. Text alignment has two components: horizontal and vertical. References: 4.4.2 4.4.5 Errors: 8 GKS not in proper state: GKS shall br! in one of the states GKOP, WSOP. WSAC or SGOP

SET FILL AREA INDEX Parameters: In fill area index

GKOP,WSOP,WSAC,SGOP (l..n)

LOa I

Effect: The `current fill area index' entry in the GKS state list is set to the value specified by the parameter. This value is used when creating subsequent FILL AREA output primitives. References: 4.4.2 4.4.6
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Errors: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP 80 Fill `area index is invalid

SET FILL AREA INTERIOR STYLE Parameters: In fill area interior style

GKOP,WSOP,WSAC,SGOP (HOLLOW,SOLID,PATTERN,HATCH)

Lth E

Effect: The `current fill area interior style' entry in the GKS state list is set to the value specified by the parameter. This value is used for the display of subsequent FILL AREA output primitives, created when the `current f31 area interior style ASF' entry `in the GKS state list is INDIVIDUAL. This value does not affect the display of subsequent FILL AREA output primitives, created when the `current fill area interior style ASF' entry in the GKS state list is BUNDLED, The fill area interior style is used to determine in what style the area is tiled and the possible values are: HOLLOW, SOLID, PATTERN and HATCH (see 4.4.6). If the requested interior style is not available on a workstation,
tion.

HOLLOW is used on that `worksta-

References: 4.4.2 4.4.6 Errors: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP

SET #ILL AREA STYLE INDEX Parameters: In fill area style index

GKOP,WSOP,WSAC,SGOP (-n..-1,l.n)

L0a I

Effect: The `current fill area style index' entry in the GKS state list is set to the value specified by the parameter. This value is used for the display of subsequent FILL AREA output primitives, created when the `current fill area style index ASF' entry in the GKS state list is INDIVIDUAL. This value does not affect the display of subsequent FILL AREA output primitives, created when the `current flll area style index ASF' entry in the GKS state list is BUNDLED. For interior styles HOLLOW and SOLID, the style index value is unused. For interior style PATTERN, the style in&x value is greater than 0 and is a pointer into the pattern tables of the workstations. For interior style HATCH, the style index value is non-zero and determines which of a number of hatch styles is used: `hatch styles greater than 0 are reserved for registration; hatch styles less than 0 are workstation dependent. If the requested style index is not available on a particular workstation, style index 1 is used on that workstation. If style index 1 is not present on that workstation, the result is workstation dependent.
NOTE - Hatch styk values are registered in the IS0 International Register of Graphical Items, which is maintained by the Registration Authority (see 4.1.2). When a hatch style has been approved by ISO, the hatch style value will be assigned by the Registration Authority.

References: 4.4.2 4.4.6
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Errors: ' 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP 84 Style (pattern or hatch) index is equal to zero

SET FILL AREA COLOUR INDEX Parameters: In Ill1 area colour index

GKOP,WSOP,WSAC,SGOP (0.n)

I.& I

Effect: The `current 6ll area colour index' entry, in the GKS state list is set to the valw ape&led by the parameter. This value is used for the display of subsequent FILL AREA output primitives, created when the `current fill area colour index ASF' entry in the GKS state list is INDIVIDUAL. This value does not'affect the display of subaeqwnt FILL AREA output primitives, created when the `current 6ll area colour index ASF' entry in the_GKS state list is BUNDLED. The colour index is a pointer into the colour tables of the workstations. If the specified colour in&x is not present in a workstation colour table, a workstation dependent colour index is used on that workstation. References: 4.4.2 44.6 Errors: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP 92 Colour in&x is less than zero

SET PATTERN SIZE Parameters: In pattern size

GKOP,WSOP,WSAC,SGOP WC SX,SY >o

LOa 2xR

Effect: The `current pattern width vector' entry in the GKS state list is set to the vector (S&O). The `current pattern height vector' entry in the GKS state list is set to the vector (0,SY). When the currently selected (either via the fill area bundle or individually, depnding on the corresponding ASF) Ill1 area interior *style is PATTERN, these values are used, where possible, in conjunction with the `current pattern reference point' entry in the GKS state list for displaying the FILL AREA output primitives. References; 4.4.2 4.4.6 Errors: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP 87 Pattern size value is not positive

SET PATTERN REFERENCE Parameters: In reference point

POINT ,*

GKOP,WSOP,WSAC,SGOP WC

LOa P
'

Effect: The `current pattern reference point' entry in the GKS state list is set to the value sp&cified by the parameter. When the currently selected (either `via the fill area bundle or individually, depending upon the corresponding ASF) fill area interior style is PATTERN, this value-is used, where possible, in conjunction with the `current pattern width vector' and `current pattern height vector' entries in the \

IS : 12399 - 1,987 IS0 7942 - 1985

GKS state list for displaying the FILL AREA output primitives. References: 4.4.2 4.4.9 Errors:. 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP

SET ASPECT SOURCE FLAGS Parameters: In list of Aspect Source Flags

GKOP,WSOP,WSAC,SGOP (BUNDLED,INDIVIDUAL) 13xE

Effect: The Aspect Source Flags (ASFs) in the GKS state list are set to the values indicated by the paramet&. The elements of the list of ASFs are arranged in the following order: linetype ASF linewidth scale factor ASF polyline colour index ASF marker type ASF marker size scale factor ASF polymarker colour index ASF text font and precision ASF character expansion factor ASF character spacing ASF text colour index ASF fill area interior style ASF fiharea style index ASF * fill area colour index ASF References:' 4.4.2 ,/ Errors: 8 GKS'irot in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP

II

SET PICK IDENTIFIER Parameters: In pick identifier

GKOP,WSOP,WSAC,SGOP

Llb N

Effect: The `current pick identifier' entry in the GKS state list is set to the value specified by the parameter. References: ,. 4.4.2 4.7.1 4.8.1
`4.8.4

Errors: 8 GKS not in proper state: GKS shall be in one of the &ates GKOP, WSOP, WSAC or SGOP t 97 Pick ident@er is invalid \,'

89

IS : 12369-1987 IS0 7942 - 1985
Output attributes 5.4.2 Workstation attributes (representations) SET POLYLINE REPRESENTATION Parameters:
In GK!ShllNthS

WSOP,WSAC,SGOP

Lla
N

In In In In

workstation identifier polyline index linetype linewidth scale factor polyline colour index

(1.n) (-n..-1,l.n) (O?n;

I I R I

Effect: In the polyline bundle table of the workstation the specified parameters. Linetype: linetype values produce linetypes as indicated:

state list, the given polyline index is associated with

co
1 2 3 4 25

implementation dependent solid line dashed line dotted line dashed-dotted line reserved for registration
\

Linewidth scale factor: a scale factor applied to the nominal linewidth. nearest available, linewidth. Polyline colour index: pointer into the colour table of the workstation.

The result is mapped by the workstation to the

The polyline bundle table in the workstation state list has predefined entries taken from the workstation description table; a number (see table 2, in 4.10) are predefined for every workstation of category OUTPUT and OUTIN. Any table entry (including the predefined entries) may be redefined with this function. When polylines are displayed, the polyline index refers to an entry in the polyline bundle table. If polylines are displayed pith a polyline index that is not present in the polyline bundle table, polyline index 1 is used. Which of the aspects in the entry are used depends upon the setting of the corresponding ASFs (see 4.4.2).
NOTE - Linetype values are registered in the IS0 International Register of Graphical Items, which is maintained by the Registration Authority (see 4.1.2). When a linetype has been approved by ISO, the linetype value will be assigned by the Registration Authority.

References: 4.4.3 4.5.3 Errors: 7 20 25 33 35 36 60 63 64 65 93

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP SpeciJied workstation identifier is invalid Specified workstation is not open Specified workstation is of category MI Specified workstation is of category INPUT SpeciJed workstation is Uiorkstation Independent Segment Storage Polyline index is invalid Linetype is equal to zero Specified linetype is not supported on this workstation Linewidth scale factor is less than zero n Colour index is invalid
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GKS functions SET POLYMARKER Parameters: In In In In In workstation identifier polymarker index marker type marker size scale factor polymarker colour index (l..n) (-n..-1,l.n) (O$ N I I R I REPRESENTATION Omtpmt rttlimes WSOP,WSAC,SCOP Llr

Effect: In the polymarker bundle table of the workstation state list, the given polymarker index is associated with the specified parameters. \ Markertype: marker type values produce centred symbols as indicated: co implementation dependent 1 + 2 8 3 0 4 5 X -*"`reserved for registration 26 Marker type 1 is always displayed as the smallest displayable dot. Ma.rker scale factor: a scale factor applied to the nominal marker size. The result is mapped by the workstation to the nearest available marker size. Polymarker colour index: a pointer into the colour table of the workstation. The polymarker bundle table in the workstation state list has predetied entries taken from the workrtation description table; a number (see table 2, in 4.10) are predegned for every work&&ion of category OUTPUT and OUTIN. Any table entry (including the predefmed entries) may be red&red with this function. When polymarkers are displayed, the polymarker index refers to an entry in the polymarker bundle table. If polymarkers are displayed with a polymarker index that is not present in the polymarker bundle table, polymarker in&x 1 is used. Which of the aspects in the entry are used depends upan the setting of the corresponding ASFs (see 4.4.2).
NOTE - Marker type values are registered in the IS0 International Register of Graphical Itcmr, which ia maintained by the Rc&~tion Authority (sac 4.1.2). When a marker type has been approved by ISO, the marker type value will be dgd Registration Authority. by the

References: 4.4.4 4.5.3 Errors: 7 20 -2s 33 35 36 46 69 70 71 93

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation ident#er is invalid Specified workstation is not open Specified workstation is of category MI Spectfied workstation is of category INPUT Specified workstation is Workstation Independent Segment Storage Polymarker index is invalid Marker type is equal to zero Specified marker type is not supported on this workstation Marker size scale factor is less than zero Colour index is invalid
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output attrlktes

GKS functions WSOP,WSAC,SGOP L18 N (l..n) (-n..-l,l..n;STRING,CHAR,STROKE) >o (O..n) state list, the given text index is associated (I;Ef R R I with the

SET TEXT REPRESENTATION Parameters: In In In In In In workstation identifier text index text font and precision character expansion factor character spacing text colour index

Effect: In the text bundle table of the workstation specified parameters.

Text font and precision: a single text aspect; a particular text font can be available at some, but not necessarily all, precisions. The text font value is used to select a particular font on this workstation. Text font 1 contains a graphical representation of the characters defined in IS0 646 (see 4.4.5). Text fonts greater than 1 are reserved for registration. Text fonts less than 0 are implementation dependent. The text precision value determines the fidelity with which the other text aspects are used. The values of text precision, in order of increasing fidelity, are STRING, CHAR and STROKE (see 4.4.5). Character expansion factor: specifies the deviation of the width to height ratio of the characters from the ratio indicated by the font designer. Character spacing: specifies how much additional space is to be inserted between two adjacent character Character spacing is specified as a fraction of the font-nominal character height. Text colour index: a pointer into the colour table of the workstation. The text bundle table in the ik-orkstation state list has predefined entries taken from the workstation description table; a number (see table 2 in 4.10) are predefined for every workstation of category OUTPUT and OUTIN. Any table entry (including the predefined entries) may be redefined with this function. When text is displayed, the text index refers to an entry in the text bundle table. If text is displayed with a text index that is not present in the text bundle table, text index 1 is used. Which of the aspects in the entry are used depends upon the setting of the corresponding ASFs (see 4.4.2).
NOTE - Text font numbers are registered in the IS0 International Register of Graphical Items, which is maintained by the Registration Authority (see 4.1.2). When a text font has been approved by ISO, the text font number will be assigned by the Registration Authority.

bodies.

References: 4.4.5 4.5.3 Errors: 7 20 25 33 35 36 72 75 76 77 93

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation identifier is invalid Spectped worksiation is not open Specified workstation is of category MI Specified workstation is of category INPUT Specified workstation is Workstation Independent Segment Storage Text index is invalid Text font is equal to zero Requested text font is not supported for the specified precision on this workstation Character expansion factor is less than or equal to zero Colour index is invalid
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I
CKS functions SET FILL AREA REPRESENTATION Parameters: In In In In In workstation identifier fill area index fill area interior style fill area style index fill area colour index (l..n) (HOLLOW,SOLID,PATTERN,HATCH) (-n..-l,l..n) (0. .n) N I E I I WSOP,WSAC,SGOP Llr

Effect: In the fill area bundle table of the workstation state list, the given fill area index is associated with the specified parameters. Fill area interior style: is used to determine in what style the area is filled and the possible values are: HOLLOW, SOLID, PATTERN and HATCH (see 4.4.6). Fill area style index: For interior styles HOLLOW and SOLID, this value is unused. For interior style PATTERN, this value is greater than 0 and is a pointer into the pattern table of the workstation. For interior style HATCH, this value is non-zero and determines which of a number of hatch styles is used: hatch styles greater than 0 are reserved for. registration; hatch styles less than 0 are workstation dependent. Fill area colour index: pointer into the colour table of the workstation. The,fill area bundle table in the workstation state list has predefined entries taken from the workstation description table; a number (see table 2 in 4.10) are predefined for every workstation of category OUTPUT and OUTIN. Any table entry (including the predefined entries) may be redefined with this function. When fhl area is displayed, the current fill area index refers to an entry in the fill area bundle table. If fill areas are displayed with a fill area index that is not present in the fill area bundle table, fill area index 1 is used. Which of the aspects in the entry are used depends upon the setting of the corresponding ASFs (see 4.4.2).
NOTE Hatch style values are registered in the IS0 Intcmational Register of Graphical Items, which is maintained by the Registration Authority (see 4.1.2). When a hatch style has be-en approved by ISO, the hatch style value will be assigned by the Registration Authority.

References: 4.4.6 4.5.3 Errors: 7 20 25 33 35 36 80 83 85 86 93

GKS not in proper state: GKS shah be in one of the states WSOP, WSAC or SGOP. Specified workstation identifier is invalid Specified workstation is not open Specified workstation is of category MI Specified workstation is of category INPUT Specified workstation is Workstation Independent Segment Storage Fill area index is invalid SpecifiedJirr area interior style is not suprsarted on this workstation Specified pattern index is invalid Specified hatch style is not supported on this workstation Colour index is invalid
*
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lSt12369-1987 ~sd 7942 - 1985 Omtpt attributes SET PATTERN REPRESENTATION Parameters: In In In In workstation identifier pattern index dimensions of pattern array DX,DY pattern array N (l..n) I (1.n) 2x1 (O..n) n x n x I state list, the given pattern index is associated with the GKS fmctions WSOP,WSAC,SGOP Lla

Effect: In the pattern table of the workstation specitied parameters.

A grid of DX x DY cells is specified. The colour is given individually for each cell, by a colour index, a pointer into the colour table of the workstation. The arrangement of cells is described in 4.4.6. If the workstation supports interior style PATTERN, the pattern table in the workstation state list has predefined entries taken from the workstation description table; a number (see table 2 in 4.10) are predefined for every workstation supporting interior style PATTERN. Any table entry (including the predefined entries) may be redefined with this function. When a fill area is displayed, if the currently selected (either via the Cl1 area bundle or individually, depending upon the corresponding ASF) interior style is PATTERN, the currently selected style index refers to an entry in the pattern table. If Rll areas are displayed with a pattern index that is not present in the pattern table, pattern index 1 will be used. If pattern index 1 is not present (i.e. interior style PATTERN is not supported for this workstation), the result is workstation dependent. References; 4.4.6 4.5.3 Errors: 7 20 25 33 35 36 85 90 91 93

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Spectfied workstation iden@er is invalid Specified workstation is not open Spectfied workstation is of category MI Spec@ed workstation is of category INPUT Specified workstation is Workstation Independent Segment Storage Specified pattern index is invalid Interior style PATTERN is not supported on this workstation Dimensions of colour array are invalid Colour index is invalid

SET COLOUR PEPRESENTATION Parameters: In In In workstation identifier colour index colour (red,green,blue intensities)

WSOP,WSAC,SGOP

LOI N

(O..n) [O,l]

'

3x:

Effect: In the colour table of the workstation state list, the given colour index is associated with the specified colour. The colour is mapped by the workstation to the nearest available. The colour table in the workstation state list has predefined entries taken from the workstation description table; at least indices 0 and 1 are predefined for every workstation of category OUTPUT and OUTIN. Any table entry (including the predefined entries) may be redefined with this function. When output primitives are displayed, the colour index refers to an entry in the colour table. If output primitives are displayed with a colour index that is not present in the colour table, a workstation dependent colour index, derived from the colour index not present, will be used. T&e background colour is defined by colour index 0.
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NOTE

- On monochrnme workstations, the intensity is computed from rho COIOUP values in H workstation dependent way.

References: 4.4.r 44.9 45.3 Errors. 7 20 25 33 35 36 93 94

GKS not in proper state: GKS shall be in one qf the states WSOP, WSAC or SGOP Speci$ed workstation identzjier is imvaiiid Specjfied workstation is not open Specified workstation is of category MI Sper$Ted workstation is of category INPUT Specified workstation i.s Workstation Independent Segment Storage Colour index is invalid Colour is outside range [OJ]
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5.5 `Transformation functions 3.5.1 Nomdizrttoa transformation SET WINDOW Parameters: In In transformation number window limits XMIN < XMAX,YMIN c YMAX transformation (l..n) WC 4xR I GKOP,WSOP,WSAC,SGOP L&t

Effect: The window limits entry of the specified normalization the value specified by the parameter. References: 4.6.1 4.8.4

in the GKS state list is set to

Errors: 8 GK,S not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP 50 Transformation number is invalid 51 `Rectangle de$nition is invalid

SET VPEWPCDRT Parameters: In In transformation number viewport limits XMIN < XMAX,YMIN < YMAX

GKOP,WSOP,WSAC,SGOP (1.n) NDC

L0a I 4xR

Effect: The viewport limits entry of the specified normalization transformation in the GKS state list is set to the value specified by the parameter. If the `current normalization transformation number' entry in the GKS state list is the same as the specified transformation number, the `clipping rectangle' entry in the GKS state list is set to the specified viewport limits. References: 4.6.1 4.8.4 Errors: 8 50 51 52 (,
i

GKS not in proper state: GKS shall be in one of the states GKOP. WSOP. WSAC or SGOP Transformation number is invalid Rectangle definition is invalid Viewport is not within the Normalized Device Coordinate unit square

SET VIEWPORT INPUT PRIORITY Parameters: In In In transformation number reference transformation relative priority number

GKOP,WSOP,WSAC,SGOP (O..n) (O..n) (HIGHER,LOWER)

Mb I E'

Effect: The viewport input priority to the next higher or next specified relative priority. transformation number, the

of the specified normalization rransformation in the GKS state list is set lower priority relative to the referent ,transformation according to the / r is the same as the reference If the specified transfo ' ation `-ritnnL "g _ function has no effect.
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References: 4.6.4 4.8.4 Errors: 8 GKS not in proper state: GKS shall be in one of the states GKOP. WSOP, WSAC or SGOP 50 Transformation number is invalid

SELECT NORMALIZATION Parameters: In transformation number

TRANSFORMATION

GKOP,WSOP,WSAC,SGOP (0.n)

L0a I

Effect: The `current normalization transformation number' entry in the GKS state list is set to the value specified by the parameter. The `clipping rectangle' entry in the GKS state list is set to the viewport limits of the specified transformation number. References: 4.6.1 Errors: 8 GKS not in proper state: GKS shall be in one of the states GKOP. WSOP, WSAC or SGOP 50 TranJfonnation number is invalid

SET CLIPPING Parameters: In

INDICATOR

GKOP,WSOP,WSAC,!3COP (CLIP,NOCLIP)

uh E

clipping indicator

Effect: The `clipping indicator' entry in the GKS state list is set to the value specified by the parameter. References: 4.6.2 4.7.4 4.7.6 4.8.4 Errors: 8 GKS not in froper state: GKS shall be in one of the stales GKOP. WSOP, WSAC or SGOP 5.5.2 Workstation tramfomation SET WORKSTATION Parameters: In In workstation identifier workstation window limits XMIN < XMAX,YMIN < YMAX NDC N 4xR is WINDOW WSOP,WSAC,SG 3P LQa

Effect: The `requested workstation window' entry in the workstation set to the value specified by the parameter.

state list of the specified workstation

If the `dynamic modification accepted for workstation transformation' entry in the; workstation description table is set to IMM, or if the `display surface empty' entry in the workstat!c,n state list is set to EMPTY, then the `current workstation window' entry in the workstation state li!lt is set to the value specified by the parameter and the `workstation transformation update state' trnrry is set to NOTPENDING. Otherwise the `workstation transformation update state' entry in the workstation

IS: 12369 - 1987 IS0 7942 - 1985
Transform&ion functions state list is set to PENDING References: 4.6.3 Errors: 7 20 25 33 36 51 53 and the `current workstation window' entry is not changed. GJe fHlctions

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation identifier is invalid SpeciJied workstation is not open Specified workstation is of category MI Specified workstation is Workstation In&end&t Segment Storage Rectangle definition is invalid Workstation window is not within the Normalized Device Coordinate unit square>

SET WORKSTATION VIEWPORT Parameters: In In workstation identifier workstation viewport limits XMIN < XMAX, YMIN < YMAX

WSOP,WSAC,SCOP

LOa N 4xR

DC

Effect: The `requested workstation viewport' entry in the workstation state list of the specified workstation is set to the value specified by the parameter. If the `dynamic modification accepted for workstation transformation' entry in the workstation ' description table is set to IMM, or if the `display surface empty' entry in the workstation state list is set to EMPTY, then the `current workstation viewport' entry in the workstation state list is set to the value specified by the parameter and the `workstation transformation update state' entry is set to NOTPENDING. Otherwise the `workstation transformation update state' entry in the workstation state list is set to PENDING and the `curmnt workstation viewport' entry is not changed. References: 4.6.3 Errors: 7 20 25 33 36 51 54

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation identifier is invalid Specified workstation is not open Specified workstation is of category MI Specified workstation is Workstation Inaizpendent Segment Storage Rectangle definition is invalid Workstation viewport is not within the display space
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5.6 Segment functions
5.5.1 !hgment manipulation fmctirrm CREATE SEGMENT Parameters: In segment name N Effect: GKS is set into the operating state SGOP = `Segment open'. The segment state list is set up and initial&d as indicated in 6.7. The segment name is recorded as the `name of the open segment' in the GKS state list (see 6.4). All subsequent output primitives until the next CLOSE SEGMENT will be collected into this segment. The segment name is entered in the `set of stored segments for this workstation' in the workstation state list (see 6.5) for every active workstation. All active workstations are included in the `set of associated workstations' of the segment state list of the newly opened segment. The segment name is entered into the `set of segment names in use' in the GKS state list. Primitive attributes are not affected. References: 4.7.1 Errors: 3 GKS,not in proper state: GKS shall be in the state &AC I.20 Specijied segment name is invalid 121 Specified segment name is already in use WSAC I41;

CLOSE SEGMENT Parameters: none

SGOP

Llr

Effect: GKS is put into the operating state WSAC = `At least one workstation active'. Primitives may no longer be added to the previously open segment. The `name of the open segment' in the GKS stak list (see 6.4) becomes unavailable for inquiry. References: 4.7.1 Errors: 4 GKS not in proper state: GKS shall be in the state, SGOP

RENAME SEGMENT Parameters: In In old segment name new segment name

WSOP,WSAC,SGOP

Llr N N

Effect: Each occurrence of old segment name in the `set of stored segments for this workstation' in a workstation state list (see 6.5) and in the `set of segment names in use' in the GKS state list is replaced by new segment name. If old segment name is the name of the open segment, the `name of the open segment' in the GKS state list is set to new segment name.
NOTE - The old segment name may be reused by the application program. t
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'

sesmcatReferences: 4.7.1 Errors: 7 I20 121 122

GKS lbetlom

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP SpecyEed segment name is invalid Spectfid segment name is already in use Specified segment does not exist

DELETE SEGMENT Parameters: In segment name

WSOP,WSAC,SGOP

Lla N

Effbt: `The segment is deleted. The segment name is remov&. from each `set of stored segments for this workstation' (in the workstation state lists (see 6.5)) which contains it and from the `set of segment names in use' in the GKS state list. The segment's state list is cancelled.
NOTE - The scgmen~ name may be reiucd by the application program.

References: 4.53 4.7.1 Errors: 7 GKS not 120 Specij&d I22 Speci#ed 125 Specified

in p.-oper state: GKS shall be in one of the states WSOP. WSAC or SGOP segment uame is invalid Jegmrnt does not exisr segment is open

DELFXk SEGMENT FROM WORKSTATION Parameters: Ia In workstation identifier segment name

WSOP,WSAC,SGOP

Lla N N

Effect: The segment is deleted from the specified workstation. The segment name is removed from the `set of stored segments for this workstation' in the workstation state list (see 6.5). The workstation identifier is removed from the `set of associated w&kstations' in the segment state list (see 6.7). If the `set of associated workstations' becomes empty, the segment is deleted, i.e. the DELETE SEGMENT function is performed. References: 4.5.3 4.7.1 Errors: 7 GKS not 20 Speci$ed 25 Spectjied 33 Spectjied 35 Spec@ed I20 Spect~ed I23 Spec@ed I25 Specified

in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP workstation identt@er is invalid workstation is not open workstation L of category MI workstation is of categocv INPUT segment name is invalid segment does not exist on specified workstation segment is open

t
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GKS functions ASSOCIATE SEGMENT WITH WORKSTATION Parameters: In In workstation identifier segment name N N

!kgment fuDctions
WSOP, WSAC L2a

Effect: The segment is sent to the specified workstation in the same way as if the workstation were active when the segment was created. Clipping rectangles are copied unchanged. The segment name is added to the `set of stored segments for this workstation* in the workstation state list (see 6.5). The workstation identifier is included in the `set of associated workstations' in the segment state list (see 6.7).
NOTE - If the specified segment is not present in the Workstation Independent Segment Storage, an error occurs. If the segment is already associated with the specified workstation, the function has no effect.

References: 4.5.3 4.7.1 4.7.6 Errors: 6 20 2.5 27 33 35 120 124

GKS not in proper state: GKS shall be either in the state WSOP or in the state WSAC Specified workstation identifier is invalid SpcTcifed workstation is not open Workstation Independent Segment Storage is not open Specified workstation is of category MI SpeciJed workstation is of category INPUT Specified segment name is invalid Specified segment does not exist on Workstation Independent Segment Storage

COPY SEGMENT TO WORKSTATION
\

WSOP, WSAC

L2a N N

Parameters: In In workstation identifier segment name

Effect: The primitives in the segment are sent to the specSed workstation after segment transformation and clipping at the clipping rectangle stored with each primitive. The primitives are not stored in a segment.
NOTE If the specified segment is not present in the Workstation Independent Segment Storage, an error occurs. The specified workstation cannot be the Workstation Independent Segment Storage. All primitives keep the values of the primitive attributes (for example, polyline index, character path, pick identifier). that were assigned to them when they were created, for their whole lifetime (see 4.7.1). In particular, when segments are copied, the values of the primitive attributes within the copied segments are unchanged.

References: 4.5.3 4.7.1 4.7.6

IS : 12369 - 1987 IS0 7942 - 1985
segment funetioos

GKS fuoctiom

Errors: 6 20 25 27 33 35 36 120 I24

GKS not in proper state: GKS shall be either in the state WSOP or in the state WSAC Specified workstation identiJier is invalid Specified workstation is not open Workstation Independent Segment Storage is not open Specified workstation is of category MI Specified workstation is of category INPUT Specified workstation is Workstation Independent Segr,lrqt Storage SpeciJied segment name is invalid Specified segment does not exist on Workstation Independent Segment Storage

INSERT SEGMENT Parameters: In In segment name transformation matrix

WSAC,SGOP

L2a N 2x3xR

Effect: Having been transformed as described below, the primitives contained in the segment are copied either (in state SGOP) into the open segment or (in state WSAC) into the stream of primitives outside segments. In both cases the transformed primitives are sent to all active workstations. The coordinates of the primitives contained in the inserted segment are transformed, firstly, by the segment transformation of the inserted segment, and, secondly, by applying the following matrix multiplication to them:
. ~]=~~~:h'~~~]~~~]

The original coordinates are (x y), the transformed coordinates are (x',y'), both in NDC. The values M is and Mz3 of the transformation matrix are NDC coordinates, the other values are unitless. For geometric attributes which are vectors (for example, CHARACTER UP VECTOR), the values M 13 I and Mt3 are ignored. The insert transformation (conceptually) takes place in NDC space. Other than the segment transformation, attributes of the inserted segment are ignored. . All clipping rectangles in the inserted segment are ignored. Each primitive processed is assigned a new clipping rectangle which is the clipping rectangle in the GKS state list if the `clipping indicator' entry in the GKS state list is CLIP and is [O,l] x [O,l] if the `clipping indicator' entry in the GKS state list is NOCLIP. All primitives processed by a single invocation of INSERT SEGMENT receive the same clipping rectangle.
NOTE - If the specified segment is not in the Workstation Independent Segment Storage or is the open segment, an error occurs. All primitives keep the values of the primitive attributes (for example, POLYLINE INDEX, TEXT PATH, PICK IDENTIFIER), that were assigned to them when they were created, for their whole lifetime (see 4.7.1). In particular, when segments are inserted, the values of the primitive attributes within the inserted segments are unchanged. The values of primitive attributes in the GKS state list. that are used in the creation of subsequent primitives within the segment into which the insertion takes place, are not changed by that insertion.

References: 4.5.3 4.7.6
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Errors: 5 GKS not in proper state: GKS shall be either in the state WSAC or in the state SGOP
27 I20 124 125 Workstation Independent Segment Storage is not open SpeclJied segment name is invalid Specified segment does not exist on Workstation Independent Segment Storage Specified segment is open

5.6.2 !3egment attrllmtes ' SET SEGMENT TRANSFORMATION WSOP,WSAC,SGOP Llr

Parameters: In segment name transformation matrix In

N 2x3xR

Effect: The `segment transformation matrix' entry in the segment state list of the named segment is set to the value specified by the parameter. When a segment is displayed, the coordinates of its primitives are transformed by applying the following matrix multiplication to them:

The original coordinates are (x y), the transformed coordinates are (x'y'), both in NDC. The valuesM~J and Mzs of the transformation matrix are in NDC coordinates, the other values are unitless. For geometric attributes which are vectors (for example, CHARACTER UP VECTOR), the values M 13and M23 are ignored. This function can be used to transform a segment stored on a workstation. The transformation applies to all workstations where the specified segment is stored even if they are not all active. The segment transformation (conceptually) takes place in NDC space. The segment transformation will be stored in the segment state list and will not affect the contents of the segment. The segment transformation is not cumulative, i.e. it always applies to the segment as originally created.
NOTE . Applying the same segment transformation twice to p segment gives identical results. Tha idantity tqtsformotion
shows the

segment in its original geometrical appearand.

\

References:
4.5.3 4.7.3

Errors:
7 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP 120 Specified segment name is invalid I22 SpecijCed segment does not exist

SET VISIBILITY

WSOP,WSAC,SGOP

L18

Parameters: N In segment name (VISIBLE,INVISIBLE) E In visibility Effect: The `visibility'entry in the segment state list of the named segment is set to the value specified by the t parameter.
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References: 4.5.3 4.7.2 4.8.4 Errors: 7 GKS not in proper state: GKS shall be in one of the states WSOP. WSAC or SGOP 120 Specified segment name is invalid 122 Specified segment does not exist

SET HIGHLIGHTING

WSOP,WSAC,SGOP

Llr

Parameters: In In segment name highlighting (NORMAL,HIGHLIGHTED) N E '

Effect: The `highlighting' entry in the segment state list of the named segment is set to the value specified by the parameter. If the segment is marked as HIGHLIGHTED and VISIBLE, the primitives in it are highlighted in an implementation dependent manner. References: 4.5.3 4.7.2 Errors:
7 GKS not in proper state: GKS shall be in one of the states WSOP, 120 Specified segment name is invalid

WSAC or SGOP

122 Specijied segment does not exist

SET SEGMENT PRIORITY

WSOP,WSAC,SGOP

Lla

Parameters: In In segment name segment priority N

WI

R

Effect: The `segment priority' entry in the segment state list of the named segment is set to the value specified by the parameter. Segment priority affects the display of segments and pick input if segments overlap, in which case GKS gives precedence to segments with higher priority. If segments with the same priority overlap, the result is implementation dependent.
UOI I: - :`te use of segment priority applies only to workstations where the entry `number of segment prior&es supported' in the wet kstation description table is greater than 1 or equal to 0 (indicating that a continuous range of priorities is supported). If `number of segment priorities supported' is greater than I, the range [O,l] for segment priority is mapped onto the range 1 to `numbrr of segment priorities supported' for a specific workstation before being used by a device driver. If `number of seg_ mmt prmritiez supported' is equal to 0, the implementation allows all values of segment priority to be differentiated. fht< feature is Intended to address appropriate hardware capabilities only. It cannot be used to force software checking of lntcrfcrencr hctwesn segments on non-raster displays. Ibe segment priority IS also used for picking segments.
with higher priority is delivered ism. 9 When overlapping or intersecting segments are picked, the segment this mechan-

as a result of the pick input primitive. All workstations

having pick input provide

104

IS : 12369 - 1987 IS0 7942 - 1985
CKS functions References: 4.5.3 4.7.2 4.8.4 Errors: 7 120 122 126 Segment functions

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified segment name is invalid Specified segment does not exist Segment priority is outside the range [O.l]

SET DETECTABILITY Parameters: In In segment name detectability

WSOP,WSAC,SGOP

Llb N E

(UNDETECTABLE,DETECTABLE)

Effect: The `detectability' entry in the segment state list of the named segment is set to the value specified by the parameter. If the segment is marked as DETECTABLE and VISIBLE, the primitives in it are available for pick input. DETECTABLE but INVISIBLE segments cannot be picked. References: 4.7.2 4.8.4 Errors: 7 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP I20 Speci$ed segment name is invalid 122 Specified segment does not exist
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5.7 Input function6
5.7.1 Initialisalion of &put devices INITIALISE Parameters: In In In In In In In workstation identifier locator device number initial normalization transformation number initial locator position prompt and echo type echo area XMIN < XMAX,YMIN < YMAX locator data record (l..n) (O..n) WC (-n..-l,l..n) DC N I I P I 4xR D LOCATOR WSOP,WSAC,SGDP LOb

Effect: The initial locator position, initial normaliition transformation number, prompt and echo type, echo area and locator data record are stored in the workstation state list entry for the specified LOCATOR device. For some LOCATOR prompt and echo types, two positions are required. One of the positions, which remains fixed during the input operation, is the initial locator position. The other position is the current locator position that varies dynamically as the operator uses the LOCATOR. Prompt and echo types: <o 1 2
'

prompting and echoing is LOCATOR device dependent. designate the current posiition of the LOCATOR nique. using an implementation-defined tech-

crosshair, i.e. designate the current position of the LOCATOR using a vertical line and a horizontal line spanning over the display surface or the workstation viewport intersecting at the current locator position. designate the current position of the LOCATOR using a tracking cross. designate the current position of the LOCATOR using a rubber band line connecting the initial locator position given by this function and the current locator position. designate the current position of the LOCATOR using a rectangle. The diagonal of the rectangle is the line connecting the initial locator position given by this function and the current locator position. display a digital representation of the current position of the LOCATOR in LOCATOR device dependent coordinates within the echo area. reserved for registration.

3 4 5

6

27

NOTE - LOCATOR prompt and echo type values are registered in the IS0 International Register of Graphical Items, which is maintained by the Registration Authority (see 4.1.2). When a LOCATOR prompt and echo type has been approved by ISO, the LOCATOR prompt and echo type value will be assigned by the Registration Authority.

References: 4.8.2 4.8.6
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GKS not in proper state: GKS shall be in one ofthe states WSOP, WSAC or SGOP Specified workstation identifier is invalid Specified workstation is not open Specified workstation is neither ofcategory INPUT nor qf category OUTIN Rectangle definition is invalid Specified input device is not present on workstation Input device is not in REQUEST *mode Specified prompt and echo type is not supported on this workstation Echo area is outside display space Contents of input data record are invalid Initial valete is invalid

INITIALISE Parameters: In In In In In In In In

STROKE

WSOP,WSAC,SGOP

LOb N I I I nxP I 4xR D

workstation identifier stroke device number initial normalization transformation number number of points in initial stroke points in initial stroke prompt and echo type echo area XMIN < XMAX, YMIN < YMAX stroke data record

(l..n) (O..n) (0.n) WC (-n..-l,l..n) DC

Effect: The initial stroke, initial normalization transformation number, prompt and echo type, echo area and stroke data record are stored in the workstation state list entry for the specified STROKE device. For all prompt and echo types, the first entry in the stroke data record is the input buffer size which is an integer in the range (l..n). This is compared against an implementation defined `maximum input buffer size' for this device (contained in the workstation description table). If the requested buffer size is greater, the `maximum input buffer size' is substituted in the stored data record., If the initial stroke is longer than the buffer size, an error is issued. When a STROKE measure process comes into existence, it obtains a buffer of the current input buffer size. The initial stroke is copied into the buffer, and the editing position is placed at the initial buffer editing position within it. Replacement of points begins at this initial position. If the initial buffer editing position cannot be specified in the stroke data record, the value 1 is used. Prompt and echo types: co 1 2 3 4 25 prompting and echoing is STROKE device dependent. display the current stroke using an implementa.tion defined technique. display a digital representation of the current stroke position within the echo area. display a marker at each point of the current strske. display a line joining successive points df the current stroke. reserved for registration.

If the operator enters more points than the current input buffer size, the additional points are lost. The operator should be informed of this situation. Stroke data record entries for variables such as intervals in Jc, Y and time may be provided to constrain the number of points delivered.
NOTE - For all prompt and etch0 types, the' stroke data record may contain an initial buffer editing position, which may range from 1 to length of initial stroke plus 1.

t
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Register of Graphical Items, which ip ma&

tained by the Registration Authority (see 4.1.2). When a STROKE prompt and echo type has been approved by ISO, the STROKE prompt and echo type value will be assigned b) the Registration Authority.

References: 4.8.2 4.8.6 Errors: 7 20 25 38 51 140 141 144 145 146 152 153

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation identifier is invalid Specified workstation is not open Specified workstation is neither of category INPUT nor of category OUTIN Rectangle definition is invalid Specified input device is not present on workstation Input device is not in REQUEST mode Specified prompt and echo type is not supported on this workstation Echo area is outside display space Contents of input data record are invalid Initial value is invaiid Number of points in the initial stroke is greater than the bufer size

INITIALISE VALUATOR Parameters: In In In In In In workstation identifier valuator device number initial value prompt and echo type echo area XMIN < XMAX,YMIN valuator data record

WSOP,WSAC,S(GOP

Lob N I R I 4xR D

(l..n) (-n..-l,l..n) < YMAX DC

Effect: The initial value, prompt and echo type, echo area and valuator data record are stored in the workstation state list entry for the specified VALUATOR device. For all VALUATOR prompt and echo types, the valuator data record includes, in the first two positions, a low value and a high value, in that order, specifying the range. The values from the device will be scaled linearly to the specified range. Prompt and echo types: <O 1 2 3 24
NOTE

I

prompting and echoing is VALUATOR designate the current VALUATOR display a graphical representation (for example, a dial oc a pointer). display a digital representation reseived for registration.

device dependent. defined technique. value within the echo area

value using an implementation of the current VALUATOR

of the current,VALUATOR

value within the echo area.

- VALUATOR

prompt and echo type va.lues are registered in the IS0 Iniernational Register of Graphical Items.whichis maintained by the Registration Authority (I,ee 4.1.2). When a VALUATOR prompt and echo ty pe has been approved by ISO, the prompt and echo type v,alue will be assigned by the Registration Authority.

VALUATOR

References: 4.8.2 4.8.6
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Errors: 7 20 25 38 51 140 141 144 145 I46 152

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation identifier is invalid Specified workstation is not open Specified workstation is neither of category INPUT nor of category OUTIN Rectangle definition is invalid Specified input device is not present on workstation Input device is not in REQUEST mode Specified prompt and echo type is not supported on this workstation Echo area is outside display space Contents of input data record are invalid Initial value is invalid

INITIALISE CHOICE

WSOP,WSAC,SGOP

LOb

Parameters: In In In In In In In workstation identifier choice device number initial status initial choice number prompt and echo type echo area XMIN < XMAX,YMIN < YMAX choice data record N (l..n) (OK,NOCHOICE) (In) (-n..-l,l..n) DC : I I 4xR D

Effect: The initial status, initial choice number, prompt and echo type, echo area and choice data record are stored in the workstation state list entry for the specified CHOICE device. Prompt and echo types: <o 1 2 prompting and echoing is CHOICE device dependent. designate the current CHOICE number using an implementation defined technique. the physical input devices that are most commonly used to implement a CHOICE logical input device normally have a built-in prompting capability. This prompt and echo type allows the application program to invoke this prompting capability. If the value of the i-th element of `prompt array' in the choice data record is OFF, prompting of the i-th alternative of the specified choice input device is turned off. An ON value indicates that prompting for that alternative is turned on. The first entry in the choice data record is the number of choice alternatives. This is compared against an implementation defined `maximum number of choice alternatives' for this device (contained in the workstation description table). If the maximum value is exceeded, an error is issued. The `second entry in the choice data record is the `prompt array'. allow the operator to indicate a CHOICE number by selecting, using an appropriate technique, one of a set of CHOICE strings. The CHOICE strings are contained in the choice data record and are displayed within the echo area. The logical input value is the number of the string, selected. The first entry in the choice data record is the number of choice strings. This is compared against an implementation defined `maximum number of choice alternatives' for this device (contained in the workstation description table). If the maximum value is exceeded, an error is issued. The second entry in the choice data record is the `array of choice strings'. allow the operator to indicate a CHOICE number by selecting, via an alphanumeric keyboard, one of a set of CHOICE strings. The CHOICE strings are contained in the choice data record and may be'displayed in the echo area as a prompt. The string typed in by the operator is echoed in the echo area. The logical input value is the number of the string that has been typed in by the operator. The first entry in the choice data record is the number of choice strings. This is compared against an implementation defined `maximum number of choice ,altematives' for this device (contained in the workstation / 109
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description table). If the maximum value is exceeded, an error is issued. The second entry in the choice data record is the `array of choice strings'. 5 the segment named by the choice data record is interpreted during execution of INITIALISE CHOICE for later use as a prompt of the specified CHOICE device. It will be displayed within the echo area by mapping the unit. square [O,l] x [O,l] of NDC space onto the echo area. The pick identifiers in the segment are mapped to CHOICE numbers in a CHOICE device dependent fashion. Picking these primitives selects the corresponding CHOICE value. After the interpretation 1.0 logical connection between the specified segment and the specified CHOICE device exists. The first entry in the choice data record is the segment name. reserved for registration.

26

NOTE - CHOICE prompt and echo type values are registered in the IS0 International Register of Graphical Items, which is maintained by the Registration Authority (see 4.1.2). When a CHOICE prompt and echo type has been apprdved by ISO, the CHOICE prompt and echo type value will be assigned by the Registration Authority.

References: 4.8.2 4.8.6 Errors: 7 20 25 38 51 140 141 144 145 146 152
GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation identifier is invalid Spec$ed workstation is not open Spectfied workstation is neither of category INPUT nor of category OUTIN Rectangle definition is invalid Specified input device is not present on workstation Input device is not in REQUEST mode Spectfied prompt and echo type is not supported on this workstation Echo area is outside display space Contents of input data record are invalid Initial value is invalid

INlTIALISE

PICK

WSOP,WSAC,SGOP

Llb . N

Parameters: In In In In In In In In workstation identifier pick device number initial status initial segment initial pick identifier prompt and echo type echo area XMIN < XMAX,YMIN < YMAX pick data record
I

(l..n) (OK,NOPICK)

(-n..-1,l.n) DC

I E N N I 4xR D

Effect: The initial status, initial segment, initial pick identifier, prompt and echo type, echo area and the pick data record are stored in the workstation state list entry for the specified PICK device. Prompt and echo types: <o 1 2 prompting and echoing is PICK device dependent. use an implementation-defined a short period of time. technique that at least highlights the `picked' primitive for

echo the contiguous group of primitives within the segment with the same pick identifier as the `picked' primitive, or all primitives of the segment with the same pick iddntifier as the `picked' primitive.
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echo the whole segment containing the `picked' primitive. reserved for registration.
and echo type values are registered Authority (see 4.1.2). in the IS0 International Register of Graphical Items, which is maintained by ISO, the PICK prompt by and When a PICK prompt Authority. and echo type has been approved

24
NOTE - PICK prompt the Registration

echo type value will be assigned

by the Registration

References: 4.8.2 4.8.6 Errors: 7 20 25 37 51 140 141 144 145 146 152

GKS not in proper state: GKS shall be in one of the states WSGP, WSAC or SGOP Specified workstation ident@er is invalid Specified workstation is not open .Spect$ed workstation is not of category OUTIN Rectangle definition is invalid Specified input device is not present on workstaticn Input device is not in REQUEST mode Spectfled prompt and echo type is not supported on this workstation Echo area is outside display space Contents of input data record are invalid Initial value is invalid

INITIALISE Parameters: In In In In In In

STRING

WSOP,WSAC,SGOP

Mb

workstation identifier string device number initial string prompt and echo type echo area XMIN < XMAX,YMIN < YMAX string data record

(1.n) (-n..-l,l..n) DC

N I S I 4xR D

Effect: The initial string, prompt and echo type, echo area and string data record are stored in the workstation state list entry for the specified STRING device. For all prompt and echo types, the first entry of the string data record is the input buffer size, which is an integer in the range (l..n). This is compared against an implementation defined `maximum input buffer size' for this device (contained in the workstation description table). If the requested buffer size is greater, the `maximum input buffer size' is substituted in the stored record. If the initial string is longer than the buffer size, an error is issued. For all prompt and echo types, the second entry of the string data record is an initial cursor position, which may range from 1 to the length of the initial string plus 1. When a STRING measure process comes into existence, it obtains a buffer of the current input buffer size. The initial string is copied into the buffer, and the cursor is placed at the initial cursor position within it. Replacement of characters begins at this cursor position. Prompt and echo types: <o 1 22
NOTE - If the operator

prompting and echoing is STRING device dependent. display the current STRING value within the echo area. reserved for registration.
enters more characters

'
input buffer size. the additional characters are lost. I)

than the current
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STRING prompt and echo type values are registered in the IS0 International Register of Graphical Items, which is maintained by the Registration Authority (see 4.1.2). When a STRING prompt and echo type has been approved by ISO, the STRING prompt and echo type value will be assigned by the Registration Authority.

References: 4.8.2 4.8.6 Errors: 7 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP 20 Specified workstation identifier is invalid 2.5 Specified workstation is not open 38 Specified workstation is neither of category INPUT nor of category OUTIN 51 Rectangle definition is invalid 140 Specified input device is not present on workstation 141 Input device is not in REQUEST mode 144 Specified prompt and echo type is not.supported on this workstation 145 Echo area is outside display space 146 Contents of input data record are invalid 152 Initial value is invalid 154 Length of the initial string is greater than the buffer size
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GKS functions 5.7.2 Setting the mode ,of input devices SET LOCATOR MODE Parameters: In In In In workstation identifier locator device number operating mode echo switch N (1.n) (REQUiZST,SAMPLE,EVF!NT) (ECHO,NOECHO) : E WSOP,WSAC,SGOP .Lob

Effect: The given I,QCATOR device is set to the specified operating mode and its echoing state is set to ECHO or NOECHO. Depending on the specified operating mode, an interaction with the given device may begin or end. The input device state defined by `operating mode' and `echo switch' is stored in the workstation state list for the given LOCATOR device. References: 4.8.1 48.3 Errors: 7 20 25 38 140 143

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Spectfied workstation identifier is invalid Specified workstation is not open Specijied workstation is neither of category INPUT nor of category OUTIN Specified input ,device is not present on workstation EVENT and SAMPLE input mode are not available at this level of GKS

SET STRQKE MODE Parameters: In In In In Effect: workstation identifier stroke device number operating mode echo switch

WSOP,WSAC,SGOP

LOb N

(l..n) (REQUEST,SAMPLE,EVENT) (ECHO,NOECHO)

j

E

The given STROKE device is set to the specified operating mode and its echoing state is set to ECHO or NOECHO. Depending on-the specified operating mode, an interaction with the given device may begin or end. The input device state defined by `operating mode' and `echo switch' is stored in the workstation state list for the given STROKE device.

References: 4.8.1 4.8.3 Errors: 7 20 25 38 140 143

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation identtfier is invalid Specified workstation is not open Specified workstation is neither of category INPUT nor of category OUTIN Specified input device is not present on workstation EVENT and SAMPLE input mode are not available at this level of GKS
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Lob

SET VALUATOR MODE Parameters: In In In In workstation identifier valuator device number operating mode echo switch

N (l..n) (REQUEST,SAMPLE,EVENT) (ECHO,NOECHO) ; E

Effect: The given VALUATOR device is set to the specified operating mode and its echoing state is set to ECHO or NOECHO. Depending on the specified optxating mode, an interaction with the given device may begin or end. The input device state defined by `operating mode' and `echo switch' is stored in the workstation state list for the given VALUATOR device. _ References: 4.8.1 4.8.3 Errors: 7 G,KS not in proper state: GKS shall be in one of the states u/SOP,
20 2S 38 140 143

WSAC or SGOP SpecijieqJ workstation identifier is invalid Specified workstation is not open SpeciJied workstation is neither of category INPUT nor of category OUTIN Specified input device is not present on workstation EVENT and SAMPLE input mode are not available at this level of GKS

SET CHOICE MODE Parameters: In In In In workstation idehtifier choice device number operating mode echo switch

WSOP,WSAC,SGOP

LOb

N (l..n) (REQUEST,SAMPLE,EVENT) (ECHO,NOECHO) ; E

Effect: The given CHOICE device is sect to the specified operating mode and its echoing state is set to ECHO or NOECHO. Depending on the specified operating mode, an interaction with the given device may begin or end. The input device state defined by `operating mode' and `echo switch' is stored in the workstation state list for the given CHOICE device. References: 4.8.1 4.8.3 Errors: 7 20 2.5 38 140 143
,

GKS not Specified Spec$ed Specified SpeciJied EVENT

in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP workstation identijihr is invalid workstation is not open workstation is neither of category INPUT nor of category OUTIN input device is not present on workstation and SAMPLE input mode are not available at this level qf GKS
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Input functions

WSOP,WSAC,SGOP

Llb

Effect: The given PICK device is set to the specified operating mode and its echoing state is set to ECHO or NOECHO. Depending on the specified operating mode, an interaction with the given device may begin or end. The input device state defined by `operating mode' and `echo switch' is stored in the workstation state list for the given PICK device. References: 4.8.1 4.8.3 Errors: 7 20 25 37 140 143

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specafied workstation identifier is invalid Specified workstation is not open Specified workstation is not of category OUTIN Specified input device is not present on workstation EVENT and SAMPLE input mode are not available'at this level of GKS

SET STRING MODE Parameters: In In In In workstation identifier string device number operating mode echo switch

WSOP,WSAC,SGOP

LOb N

(l..n) (REQUEST,SAMPLE,EVEIUT) (ECHO,NOECHO)

: E

Effect: The given STRING device is set to the specified operating mode and its echoing state is set to ECHO or NOECHO. Depending on the specified operating mode, an interaction with the given device may begin or end. The input device state de&ted by `operating mode' and `echo switch' is stored in the workstation state list for the given STRING device. References: 4.8.1 4.8.3 Errors: 7 20 25 38 140 143

GKS not in proper state: GKS shall be in one of the states WSOP. WSAC or SGOP Specified workstation identt$er is invalid Specilfed workstation is not open Specified workstation is neither of citegory INPUT nor of category OUTIN Specified input device is not present on workstation EVENT and SAMPLE input mode are not available at this level of GKS
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5.7.3 Request input functions REQUEST LOCATOR Parameters: In In out out out workstation identifier locator device number status normalization transformation locator position N (l..n) (OK,NONE) (O..n) WC ; I P WSOP,WSAC,SGOP Mb

number

Effect: GKS performs a REQUEST on the specified LOCATOR device. If the break facility is invoked by the operator, the status NONE is returned; otherwise OK is returned together with the logical input value which is the current measure of the LOCATOR device. This measure consists of a locator position in world coordinates and the normalization transformation number, which was used in the conversion to world coordinates. The locator position is within the window of the normalization transformation. References: 4.6.4 4.8.1 4.8.2 4.8.3 4.8.4 Errors: 7 20 2.5 38 140 141

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation identifier is invalid SpeciJied workstation is not open Specified workstation is neither of category INPUT nor of category OUTIN Specified input device is not present on workstation Input, device is not in REQUEST mode

REQUEST STROKE Parameters: In In out out out out workstation identifier stroke device number status normalization transformation number of points points in stroke

WSOP,WSAC,SGOP

LOb N

number

(l..n) (OK,NONE) (O..n) (O..n) WC

: I I nxP

Effect: GKS performs a REQUEST on the specified STROKE device. If the break facility is invoked by the operator, the status NONE is returned; otherwise OK is returned together with the logical input value which is the current measure of the STROKE device. This consists of a sequence of not more than `input buffer size' (in the stroke data record) points in world coordinates, and the normalization transformation number, which was used in the conversion to world coordinates. The points in the stroke all lie within the window of the normalization transformation.
NOTE . If an operator are lost. enters more points than the stroke input buffer size (in the workstation should be informed of this situation. state list) allows the additional points The operator
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References: 4.6.5 4.8.1
4.8.2 4.8.3 4.8.4

Errors: 7 20 25 38 140 141

GKS not in proper state: GKS shall be in one of the states WSOP. WSAC Or SGOP Specified workstation identifier is invalid Spectjied workstation is not open Specified workstation is neither of category INPUT nor of category OUTIN Specljied input device is not present on workstation input device is not in REQUEST mode

REQUEST VALUATOR

WSOP,WSAC,SGOP

Lob

Parameters: In workstation identifier valuator device number In Out status Out value N (I..@ (O&NONE) ; R

Effect: GKS performs a REQUEST on the specified VALUATOR device. If the break facility is invoked by the operator, the status NONE is returned; otherwise OK is returned together with the logical input value which is the current measure of the VALUATOR device. The value delivered is in the range specified in the workstation state list entry (for this device) in the data record. References: 4.8.1 4.8.2 4.8.3 4.8.4 Errors: 7 20 25 38 140 141

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation identifier is invalid Specified workstation is not open Specified workstation is neither of category INPUT nor of category OUTIN Specified input device is not present on workstation Input device is not in REQUEST mode

REQUEST CHOICE

WSOP,WSAC.SGOP

LOb N

Parameters: workstation identifier In In choice device number Out status Out choice number (l..n) (OK.NOCHC)ICE,NONE) (1.3)

: I

Effect: GKS performs a REQUEST on the specified CHOICE device. If the break facility is invoked by the operator, the status NONE is returned; if the measure of the CHOICE device indicates no choic . status NOCHOICE is returned; otherwise OK is returned together with a choice number which is st`i according to the current measure of the CHOICE device.
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References: 4.8.1 4.8.2 4.8.3 4.8.4 Errors: 7 20 25 38 140 141

GKS not in proper state: GKS shall be in one of the stc.!cs WSOP, WSAC or SGOP SpeciJied workstation identifier is invalid Specified workstation is not open Specified workstation is neither of category INPUT nor of category OUTIN Specified input device is not present on workstation Input device is not in REQUEST mode

REQUEST PICK Parameters: In In out out out workstation identifier pick device number status segment name pick identifier

WSOP,WSAC,SGOP

Llb N

(1.A) (OK,NOPICK,NONE)

: N N

Effect: GKS performs a REQUEST ou the specified PICK device. If the break facility is invoked by the operator, the status NONE is returned; if the measure of the PICK device indicates no pick, status NOPICK is returned; otherwise OK is returned together with a segment name and a pick identifier which are set according to the current measure of the PICK device. The pick identifier is associated with the primitive, within the segment, that was picked. References: 4.8.1 4.8.2 4.8.3 4.8.4 Errors: 7 20 25 37 140 141

GKS not in proper state: GKS shall be in one of the states WSOP. WSAC or SGOP Specified workstation identifier is invalid Specified workstation is not open Specified workstation is not of category OUTIN Sp@fied input device is not present on workstation Input device is not in REQUEST mode

c

REQUEST STRSNG Parameters: In workstation identifier in string device number Out status Out character string

WSOP,WSAC,SGOP

L0b
N

(l..n) (OK,NONE) t

: S
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Effect: GKS performs a REQUEST on the specified STRING device. If the break facility is invoked by the operator, the status NONE is returned; otherwise OK is returned together with the logical input value which is the current measure of the STRING device.
NOTE -

The lengthof the returned string is less than or qua1 to the buffer&e specified in the workstation state list entry (for this device) in the data record.

References: 4.8.1 4.8.2 4.8.3 4.8.4 Errors: 7 20 25 38 140 141

GKS not in proper state: GKS shah be in one of the states WSOP, WSAC or SGOP Specified workstation identiffer is invalid *Specified workstation is not open Specified workstation is neither of category INPUT nor of category OUTIN Specified input device is not present on workstation Input device is not in REQUEST mode

5.7.4 Sample input functions SAMPLR LOCATOR Parameters: In In Out Out workstation identifier locator device number normalization transformation locator position N number WC (In) (0.n) : P WSOP,WSAC,SCOP u)c

Effect: The logical input value, which is the current measure of the specified LOCATOR device, is returned. The measure consists of a locator position in world coordinates and the normalization transformation number, which was used in the conversion to world coordinates. The locator position is within the window of the normalization transformation. References: 4.6.4 4.8.1 4.8.3 4.8.4 Errors: 7 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP 20. Specified workstation identifier is invalid 25 Specified workstation is not open 38 Specified workstation is neither of category INPUT nor of category OUTIN 140 Specified input device is not present on workstation 142 Input device is not in SAMPLE mode
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SAMPLE STROKE Parameters: In In out out out workstation identifier stroke device number normalization transformation number of points points in stroke

number WC

(1.n) (O..n) (0.n)
.

Effect: The logical input value, which is the current measure of the specified STROKE device, is returned. The measure consists of a sequence of points in world coordinates, and the normalization transformation number which was used in the conversion to world coordinates. The points in the stroke all lie within the window of the normalization transformation.
NOTE - If an operator enters more points than the stroke input buffer size (in the workstation state list) allows, the additional are lost. It is anticipated that the operator would be informed of this situation.

points

References: 4.6.5 4.8.1 4.8.3 4.8.4 Errors: 7 20 25 38 140 142

GKS nor in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation identifier is invalid Spec@ed workstation is not open Specified workstation is neither of category INPUT nor of category OUTIN Specified input device is not present on workstation Input device is not in SAMPLE mode

SAMPLE VALUATOR Parameters: In workstation identifier In valuator device number Out value

WSOP,WSAC,SGOP

LOc N I R

(l..n)

Effect: The logical input value, which is the current measure of the specified VALUATOR device, is returned. The value delivered is in the range specified in the workstation state list entry (for this device) in the data record. References: 4.8.1 4.8.3 4.8.4 Errors: 7 20 25 38 140 142

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation identifier is invalid Spect>ed workstation is not open Specified workstation is neither of category INPUT nor of category OUTIN Specified inpui device is not present on workstation Input device is not in SAMPLE mode
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WSOP,WSAC,SCOP

LOc

Effect: If the current measure of the specified CHOICE device is indicating no choice, status NOCHOICE is returned; otherwise OK is returned together with a choice number which is set according to the current measure of the CHOICE device. References: 4.8.1 4.8.3 4.8.4 Errors: 7 20 25 38 140 142

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation identifier is invalid Specified workstation is not open Specified workstation is neither of category INPUT nor of category OUTIN Specified input device is not present on workstation Input device is not in SAMPLE mode

SAMPLE PICK Parameters: In In out out out workstation identifier pick device number status segment name pick identifier

WSOP,WSAC,SGOP

Llc N

(l..n) (OK,NOPICK)

: N N

Effect: If the current measure of the specified PICK device is indicating no,pick, status NOPICK is returned; otherwise OK is returned together with a segment name and a pick identifier which are set according to the current measure of the PICK device. The pick identifier is associated with the primitive, within the segment, that was picked. References: 4.8.1 4.8.3 4.8.4 Errors: 7 20 25 37 140 142

GKS not in proper state: GKS shall be in one of the states WSOP. WSAC or SGOP Specified workstation identifier is invalid Specljied workstation is not open Specified workstation is not of category OUTIN SpeciJied input device is not present on workstation Input device is not in SAMPLE mode
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SAMPLE STRING Parameters: In workstation identifier In string device number Out character string

(1.n)

Effect: The logical input value, which is the current measure of the specified STRING device, is returned.
NOTE - The length of the returned string is less than or equal to the buffer ~i.5 specified in the workstation state list entry (for this device) in the data record.

References: 4.8.1 4.8.3 4.8.4 Errors: 7 20 25 38 140 142 5.75

GKS not in proper state: GKS shall be in one of the states WSOP. WSAC or SGOP Specified workstation identijier is invalid Spec@ed workstation is not open Specified workstation is neither of category INPUT nor of category OUTIN Specified input device is not present on workstation Input, device is not in SAMPLE mode Event inputfimctions WSOP,WSAC,SGOP LOc R N E I

AWAIT EVENT Parameters: In out out out

timeout (seconds) workstation identifier (NONE,LOCATOR,STROKE,VALUATOR,CHOICE,PICK,STRING) input class logical input device number

(l..n)

Effect: If the input queue is empty, GKS is set into a wait state until an input event is written into the queue or the time specified in the timeout parameter has elapsed. If a timeout occurs and there is still no entry in the queue, a NONE value is returned for input class. If there is at least one entry in the queue, the oldest event report is moved from the event queue to the current event report in the GKS state list. The workstation identifier, the input class, and the logical input device number are returned and the corresponding values are made available for subsequent interrogation by the GET <input class > functions.
NOTE The operation is performed even if error 147 has occurred. A timeout of zero causes an immediate inspection of the queue, and a NONE value for ,input class is returned if the queue is empty. Some operating systems may not provide a reliabk timeout facility. In this case a timeout different from zero may never cause a timeout at all.

References: 4.8.1 4.8.2 4.8.3 4.8.5 Errors: 7 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP 147 Input queue has overflowed 151 Timeout is invalid
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WSOP, WSAC,SGOP

LOc

Effect: All entries in the input queue from the specified logical input device are removed.
NOTE - The operation is performed even if error 147 has occurred.

References: 4.8.5 Errors: 7 20 25 38 140 147
GKS not in proper state: GKS shall be in one of the states WSOP, WSZC or SGOP

Specified workstation identifier is invalid Specified workstation is not open Specified workstation is neither of category INPUT nor of category OUTIN Specified input device is not present on workstation Input queue has overflowed

GET LOCATOR Parameters: Out Out normalization transformation locator position number

WSOP,WSAC,SGOP (O..n) WC

LOe I P

Effect: The LOCATOR logical input value in the current event report is returned. This consists of a locator position in world coordinates and the normalization transformation number, which was used in the conversion to world coordinates. References: 4.6.4 4.8.4 4.8.5 Errors: 7 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP 150 No input value of the correct class is in the current event report

GET STROKE Parameters: Out normalization transformation Out number of points Out points in stroke number

WSOP,WSAC,SGOP (O..n) (O..n) WC

LOe 1 I nxP

Effect; The STROKE logical input value from the current event report is returned. This consists of a sequence of points in world coordinates, and the normalization transformation number, which was used in the conversion to world coordinates. The points in the stroke all lie within the window of the normalization transformation.
NOTE - The number of points in the stroke is less lhan or equal IO lhe stroke bulTer size specitied in the workstation device. 9 slate list for this
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References: 4.65 4.8.4 4.8.5 Errors: 7 GKS not in proper state: GKS shall be in one of the states WSOP. WSAC or SGOP 150 No input value ,of the correct class is in the current event report

GET VALUATOR Parameters: Out value /

WSOP,WSAC,SGOP

LOe R

Effect: The VALUATOR logical input value in the current event report is returned. The value delivered is in the range specified in the workstation state list entry (for the device) in the data record. References: 4.8.4 4.8.5 Errors: 7 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP I50 No input value of the correct class is in the current event report

GET CHOICE Parameters: out Out status choice number

b

WSOP,WSAC,SGOP (OK,NOCHOICE) (1.n)

LOe E I

Effect: The CHOICE logical input value in the current event report is returned. status and a choice number. References: 4.8.4 4.8.5

This consists of a CHOICE

Errors: 7 GKS not @proper state: GKS shall be in one of the states WSOP, WSAC or SGOP I50 No input value of the correct class is in the current eient report

GET PICK Parameters:
out out out

WSOP,WSAC,SGOP \ (OK,NOPICK)

Llc

status segment name pick identifier

E N N

Effect: The PICK logical input value in the current event report is returned. This consists of a PICK status, a segment name and the pick identifier associated with the primitive within the segment that was picked.
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GET STRING Parameters: Out character string

WSOP,WSAC,SCOP

LOc S

Effect: The STRING logical input value in the current event report is returned.
NOTE - The length of the returned string is less than or qua1 to the buffer size specified in the workstation state list entry (for this device) in the data record, at the time the event was queued.

References: 4.8.4 4.8.5 Errors: 7 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP I50 No input value of the correct c. :ss is in the current event report
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WSACSGOP LOa N I I D

WRITE ITEM TO GKSM Parameters: In In In In workstation identifier item type item data record length item data record

(0.n)

Effect: An item containing non-graphical data provided by the application program is written to the GUM. The parameters `item data record' and `item data record length' define the data to be output whilst `item type' specifies their type.
NOTE - This function can only be used to transfer non-graphical workstation of category MO has been activated. information to GKSM. Graphical data are sent automatically after a

References: 4.9 E.rrors: 20 30 32 160 161
5 GKS not in proper state: GKS shall be either in the state WSAC or in the state SGOP Specified workstation identifier is invalid Specified workstation is not active Specified workstation is not of category MO Item type is not allowed for user items Item length is invalid

GET ITEM TYPE FROM GKSM Parameters: In workstation identifier Out item type Out item data record length

WSOP, WSAC,SGOP

LOa N I I

(O..n)

Effect: GKS inspects the type of the current item and the length of its data record in the GKSM and returns the type and length back to the application program. References: 4.9 Errors: 7 GKS not inproper
20 25 34 162 163 Specified Specified Specified No item MetaJile

state: GKS shall be in one of the states WSOP, workstation ident$er is invalid workstation is not open workstation is not of category MI is left in GKS Me!ajile input item is invalid

WSAC or SGOP

READ ITEM FROM GKSM Parameters: workstation identifier In maximum item data record length In Out item data record

WSOP,WSAC,SGOP

LOa N

* (On)

I D
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Effect: GKS returns the current item on the GKSM back to the application program and then makes the next item in the metafile the current item. If the item data record length is greater than `maximum item data record length', the excess parts of the item are lost.
NOTE - By specifying `maximum item data record length' = 0, the current item can be skipped. Any program which makes use of the access that this function provides to the content of GKSM items is usiog information that is oot part of the standard, viz. the format and content of metafile items.

References: 4.9 Errors: 7 20 25 34 162 163 165 166

GKS not in proper state: GKS shall be in one of the states WSOP. WSAC or SGOP Specified workstation identifier is invalid Specified workstation is not open Specified workstation is not of category MI No item is left in GKS Metafile input Metafile item is invalid Content of item data record is invalid for the specified item type Maximum item data record length is invalid

INTERPRET Parameters: In In In

ITEM

GKOP,WSOP,WSAC,SCOP

L8a I I D

item type item data record length item data record

(O..n)

Effect: The supplied item is interpreted. This causes appropriate changes in the set of GKS state variables (see 4.9) and the generation of appropriate graphical output, as determined by the metafile specification.
NOTE - Apart from errors noted below, other GKS errors may occur as a result of interpreting the item.

References: 4.9 Errors: 7 161 163 164 165 167 168

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Item length is invalid Metafile item is invalid Item type is not a valid GKS item Content of item data record is invalid for the specified item type User item cannot be interpreted Spectfied function is not supported in this level of GKS
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5.9.1 Introduction to inquiry functions Inquiry functions return values from the various state lists. The data types of the values and the default values of the state list entries are summarized in clause 6. Errors detected by inquiry functions are reported through an error indicator parameter, see 4.11.2. The error handling procedure is not called. The list of states in the function heading indicates those states in which the inquiry function can return valid values. Some inquiry functions that retrieve values from the workstation state lists have an input parameter of type `Enumeration that can take the following values: a) SET: b) REALIZED: the values returned are those provided by the application program. the values returned are those used by the workstation mapped to the available values in the workstation. when the actual values are

Inquiries for predefined representations in the workstation description table (see 5.9.6) have no such parameter unlike the corresponding inquiries for the representations in the workstation state list (see 5.9.5). The values of predefined representations are available on the workstation. Thus all values returned from a prede6ned representation are such that, if used by an application program to set a representation, a subsequent inquiry for that representation in the workstation state list would return the same values whether SET or REALIZED was specified. 5.9.2 Inquiry function for operatiug state value INQUIRE OPERATING STATE VALUE Parameters: Out operating state value (GKCL,GKOP,WSOP,WSAC,SGOP) E Effect: The operating state of GKS is returned. References: 4.1l.l 4.11.2 Errors: none 5.9.3 Inquiry fnnctions for GKS descriptim table INQUIRE LEVEL OF GKS Parameters:
out out ,

GKCL,GKOP,WSOP,WSAC,SGOP

LOa

GKOP,WSOP,WSAC,SGOP

LOa

error indicator level of GKS

(Oa,Ob,Oc,la,lb,lc,2a,2b,2c)

i

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to the following error number to indicate the reason for non-availability: 8 GKS not in proper state: GKS shall be in one of the states GKOP, References: 4.10 4.11.2
, M/SOP, WSAC or SGOP
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INQUIRE LIST OF AVAILABLE WORKSTATION Parameters: Out error indicator Out number of available workstation types Out list of available workstation types Effect: If the inquired information the output parameters.

TYPES

GKOP,WSOP,WSAC,SGOP

LOa I I nxN

(1.n)

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to the following error number to indicate the reason for non-availability: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP References: 4.5.1 4.11.2 Errors: none

INQUIRE WORKSTATION Parameters: Out Out Out Out

MAXIMUM NUMBERS

GKOP,WSOP,WSAC,SGOP

Lla I I I I

error indicator maximum number of simultaneously open workstations maximum number of simultaneously active workstations maximum number of workstations associated with segment is returned

(l..n) (l..n) (l..n)

Effect: If the inquired information is available, the error indicator returned in the output parameters.

as 0 and the values are

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to the following error number to indicate the rea. son for non-availability: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP References: 4.5 4.11.2 Errors: none
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LO8

Parameters:
out Out

error indicator maximum normalization

transformation

number

(l..n)

I I

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to the following error number to indicate the reason for non-availability: 8 GKS not in proper state: GKS shall be in one of the states GKbP. WSOP, WSAC or SGOP References: 4.6.1 4.11.2 Errors: none 5.9.4 Iquiry
fnnctioasfor GKS state list GKOP,WSOP,WSAC,SGOP LOa

INQUIRE SET OF OPEN WORKSTATIONS

Parameters: Out error indicator Out number of open workstations Out set of open workstations Effect: If the inquired information the output parameters. (O..n) nxN I I

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to the following error number to indicate the reason for non-availability: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP References: 4.5.2 4.11.2 Errors: none

INQUIRE SET OF ACTIVE WORKSTATIONS Parameters: Out out Out

GKOP,WSOP,WSAC,SGOP

Lla

error indicator number of active workstations set of active workstations

(O..n) nxN

I I

Effect: If the inquired infdrrnation is available, the error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to the following error number to indicate the reason for non-availability:
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WSAC or SGOP

References: 45.2 4.11.2 Errors: none

INQUIRE CURRENT PRIMITIVE ATTRIBUTE

VAIXJKS

GKOP,WSOP,WSAC,SCOP I I I R
2xR

Parameters: Out Out Out Out Out Out Out Out Out Out Out Out Out Out error indicator current polyline index ..Il current polymarker index I:*? (l..n) current text index >o WC current character height WC current character up vector >o WC current character width current character base vector (RICHT,LE%P,DOWN) current text path current text alignment (NORMAL,LEFT,CENTRE,RIGHi`rNORMAL,TOP,CAP,HALF,BASE,BOTTOM) (l..n) current fill area index WC current pattern width vector WC current pattern height vector WC current pattern reference point

R 2xR E 2xE I 2xR 2xR P

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to the following error number to indicate the reason for non-availability: 8 GKS not in proper state: GKS shall be in one of the s!ates GKOP, WSOP, WSAC or SGOP References: 4.42 4.11.2 Errors: none

INQUIRE CURRENT PICK.IDENTIFIER VALUE

GKOP,WSOP,WSAC,SGOP

Llb

Parameters: Out error indicator Out current pick identifier Effect: If the inquired information the output parameters. I N is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to the following error number to indicate the reason for non-availability:
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8 GKS not in proper state: GKS shdll be in one of the states GKOP. WSOP,

References: 4.4.2 4.7.1 4.11.2 Errors:
none

INQUIRE CURRENT INDIVIDUAL Parameters:
out out out out out out out out out out out out out out out

ATTRIBUTE

VALUES

GKOP,WSOP,WSAC,SGQP I I R I I R (I;Er R R I E I I 13xE

error indicator current linetype current linewidth scale factor current polyline colour index current marker type . current marker size scale factor current polymarker colour index current text font and precision current character expansion factor current character spacing current text colour index current fill area interior style current fill area style index current fill area colour index current list of aspect source flags

(-n..-1,l.n) (02 (-n..-l,l..n) (O!ny (-n..-l,l..n;STRING,CHAR,STROKE) >o (0.J.l) (HOLLOW,SOLID,PATTERN,HATCH) (-n..-l,l..n) (O..n) (BUNDLED,INDIVIDUAL)

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to the following error number to indicate the reason for non-availability: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP References: 4.4.2 4.11.2 Errors: none

INQUIRE CURRENT NORMALIZATION Parameters:
out out

TRANSFORMATION

NUMBER GKOP,WSOP,WSAC,SGOP

LOa I I

error indicator current normalization

transformation

number

(O..n)

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values a3 returned in
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If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to the following error number to indicate the reason for non-availability: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP References: 4.6.1 4.11.2 Errors: none

I

INQUIRE LIST OF NORMALIZATION TRANSFORMATION NUMBERS GKOP,WSOP,WSAC,SGOP Parameters: Out Out error indicator list of transformation

LQa I

numbers

nx1

Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. The transformation numbers are returned in a list, which is ordered by vieWport input priority, starting with the highest priority transformation number. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to the following error number to indicate the reason for non-availability: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP References: 4.6. I 4.11.2 Errors:

INQUIRE NORMALIZATION TRANSFORMATION Parameters: In out out out normalization transformation error indicator window limits viewport limits number

GKOP,WSOP,WSAC,SGOP (0.n) WC NDC 4xR 4xR I I

Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP. WSAC or SGOP 50 Transformation nwnber is invalid References: 4.6.1 4.11.2
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Errors: none

INQUIRE CLIPPING Parameters:
out out out

GKOP,WSOP,WSAC,!%OP

LOa

error indicator clipping indicator clipping rectangle

(CLIP,NOCLIP) NDC

: 4xR

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to the following error number to indicate the reason for non-availability: 8 GKS not kr proper state: GKS shakl lu in one of the states GKOP, WSOP, WSAC or SGOP References: 4.6.2 4.11.2 Errors: none

INQUIRE NAME OF OPEN SEGMENT Parameters:
out out .

SGOP

Ll8 I N

! Effect: If the inquired information is available, tk error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to the following error number to indicate the reason for non-availability: 4 GKS not in proper state: GKS shad be in the state SGOP References: 4.7.1 4.11.2 Errors:
none

error indicator name of open segment

INQUIRE SET OF SEGMENT NAMES IN USE Parameters: Out error indicator Out number of segment names Out set of segment names in use

WSOP,WSAC,SGOP

Lla
I

yO..n) nxN

I
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Inquiry fsuicdoua is available, the error indicator is returned as 0 and values are returned in

Effect: If the inquired information the output parameters.

If the inquired information is not available, thz values returned in the output parameters are implementation dependent and the error indicator is set to the following error number to indicate the reason for non-availability: 7 GKS not in proper state: GKS shall be in one of the states WSOP. References: 4.7.1 4.11.2 Errors: none
WSAC or SGOP

INQUIRK MORE SIMULTANKOIJS Parameters:
out out

EVENTS

WSOP,WSAC,!%OP

LOe

error indicator more simultaneous events

(NOMORE,MORE)

;

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set tlr, the following error number to indicate the reason for non-availability: 7 GKS not in proper state: GKS shall be in one of the states WSOP, References: 4.8.5 4.11.2 Errors: none 5.9.5 Inquiry functions for workstation state list INQUIRE WORKSTATION Parameters: In workstation identifier Out error indicator Out connection identifier Out workstation type N I N N CONNECTION AND TYPE WSOP,WSAC,SGOP LOa
WSAC or SGOP

Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate * the reason for non-availability: 7 GKS not in proper state: GKS shall be in one of the states 20 Specified workstation ident$er is invalid 25 Specified workstation is not open
WSOP, WSAC or SGOP *
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INQUIRE WORKSTATION Parameters: workstation identifier In Out error indicator Out workstation state

STATE

WSOP,WSAC,SGOP

Loa N

(INACTIVE,ACTIVE)

:

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: j 7 20 25 33 35 References: 4.52 4.11.2 Errors: GKS not Specified Specased Specified Specified in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP workstation identijihr is invalid workstation is not open workstation is of category MI workstation is of category INPUT

INQUIRE WORKSTATION IJEF'ERRALAND UPDATE STATES Parameters: In workstation identifier out error indicator out deferral mode out implicit regeneration mode Out display surface empty out new frame action necessary at update

WSOP,WSAC,SGOP

Lo1 N

(ASAP,BNIG,BNIL,ASTI) (SUPPRESSED,ALLOWED) (EMPTY,NOTEMPTY) (NO,YES)

: E E E

Effect: If the inquired `information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 20 25 33 35 36 136 GKS not in proper state: GKS shall be in one of the states. WSOP, WSAC or SGOP SpecijShd workstation ident#er is invalid Specified workstation is not open Specified workstation is of category Ml Specified work-station is qf category INPUT `Specified workstation is Workstation Independent Segment Storage
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References: 4.5.3 4.5.4 4.11.2 Errors: none

INQUIRE LIST OF POLYLINE INDICES

WSOP,WSAC,SGOP

L18

Parameters: N `In workstation identifier I Out error indicator (%.n) I Out number of polyline bundle table entries llXI (l..n) Out list of defined polyline indices Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 GKS not in proper state: GKS shall be in one of the states WSOP. WSAC or SGOP 20 Specijied workstation tinti$et is invalid 25 Spec$ed workstation is not open 33 Specijied workstation is of category MI 35 Specilfed workstation is of category INPUT 36 Speczjied workstation is Workstation Independent Segnient Storage References: 4.4.3 4.11.2 Errors: none

INQUIRE POLYLINE REPRESENTATION

WSOP,WSAC,SGOP

Llr

Parameters: N In workstation identifier In polyline index (I..& In type of returned values (SET,REALIZED) : I out error indicator I (-n..-l,l..al) out linetype R out linewidth scale factor (O.F$ I out polyline colour index Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the specified polyline index is not -present in the polyline bundle table on the work$ation and the specified type of returned values is REALIZED, the representation for polyline index 1 is returned.
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If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 20 25 33 35 36 60 61 References: 4.4.3 4.11.2 Errors: GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation identzjier is invalid Specified workstation is not open Specified workstation is of category MI Specified workstation is of category INPUT Specified workstation is Workstation Independent Segment Storage Polyline index is invalid A representation for the'specified polyline index has not been defined on this workstation

INQUIRE LIST OF POLYMARKER INDICES Parameters: In out out out \;orkstation identifier error. indicator number of polymarker bundle table entries list of defined polymarker indices

WSOP,WSAC,SGOP

Lla N I I nx1

(S..n) (l..n)

Effect: If the inquired information the output parameters.

is availabfle, the error indicator is returned as 0 and values are returned in

If the inquired information is not ava\ilable, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 20 25 33 35 36 References: 4.4.4, 4.11.2 Errors: none GKS not Specified Specified Specified Specified Specified in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP workstation identifier is invalid workstation is not open workstation is of category MI workstation is of category INPUT workstation is Workstcltion Independent Segment Storage

\
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GKS functions INQUIRE POLYMARKER REPRESENTATION Parameters: workstation identifier In In polymarker index In type of returned values Out error indicatorOut marker type Out marker size scale factor Out polymarker colour index Effect: If the inquired information the output parameters. N (1.3) (SETJEALIZED) (-n..-l,l..n) (O.$ : I I R I IIquiry fuections WSOP,WSAC,SGOP Ll&

is available, the error indicator is returned as 0 and values are returned in

If the specified polymarker index is not present in the polymarker bundle table on the workstation and the specified type of returned values is REALIZED, the representation for polymarker index 1 is returned. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 20 25 3.3 35 36 66 67 References: 4.4.4 4.11.2 Errors: none GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP SpeciJied workstation idenrifer is invalid Specified workstation is not open Speci$ed workstation is of category MI Specified workstation is of category INPUT Specilfed workstation is Worksraiion Independent Segment Storage Polymarker index is invalid A representation for the spec@ed polymarker index has not been defined on this workstation

INQUIRE LIST OF TEXT INDICES Parameters: In Out Out Out workstation identifier error indicator number of text bundle table entries list of defined text indices

WSOP,WSAC,SGOP

Lla N I I nx1

(6.3) (1.3)

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 20 25 33 35 36 GKS not Specified Speci$ed Specified Specified Spectjied in proper state: GKS shall be ii one of the states WSOP, WSAC or SGOP workstation identifier is invalid workstation is no"topen workstation is of category MI workstation is of category INPUT workstation is Workstation Independent Segment Storage
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' References: 4.4.5 4.11.2 Errors: none

INQUIRE TEXT REPRESENTATION Parameters: In In In out out out out Gut workstation identifier text index type of returned values error indicator text font and precision character expansion factor character spacing text colour index
.

WSOP,WSAC,SGOP

Lla N

(l..n) (SET,REALIZED) (-n..-l,l..n;STRING,CHAR,STROKE) >o (O..n)

: (I;E: R R I

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the specified text index is not present in the text bundle table on the workstation and the specified type of returned values is REALIZED, the representation for text index 1 is returned. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP 20 Specified workstation identifier is invalid 2.5 Speczjied workstation is not open 33 Specified workstation is of category MI 3.5 Specified workstation `is of category INPUT 36 Specified workstation is Workstation Independent Segment Storage 72 Te+ index is invalid 73 A representation for the specified text index has not been defined on this workstation References: 4.4.5 4.11.2 Errors: none
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IS0 7942 - 1985 GKS functions INQUIRE TEXT EXTENT Parameters: In In In out out out workstation identifier text position character string error indicator concatenation point text extent parallelogram
Inquiry

fanctieml I.&a

WSOP,WSAC,SGOP

N
WC P S I P 4xP

WC WC

Effect: If the inquired information is available, the error indicator is returned as-0 and values are returned in the output parameters. The extent of the specified character string is computed using the text font and precision, character expansion factor and character spacing currently selected (either via the bundle or individually, depending upon the corresponding ASFs) and the current text attributes (CHARACTER HEIGHT, CHARACTER WIDTH, CHARACTER UP VECTOR, CHARACTER BASE VECTOR, TEXT PATH, TEXT ALIGNMENT). If the current text index is not present in the text bundle table, text index 1 is used. At precisions STRING and CHAR, the text extent parallelogram is an approximation of that defined in 4.4.5, being the minimum which completely encloses the character bodies of the displayed string (see figure 17). For UP and DOWN text paths, the widest character body in the font is enclosed. The parallelogram is returned as four comer points in anticlockwise order. If, at STROKE precision, the CHARACTER WIDTH VECTOR and CHARACTER BASE VECTOR are perpendicular, the text extent parallelogram is a rectangle. The concatenation point can be used as the origin of a subsequent TEXT output primitive for the concatenation of character strings, where meaningful. For certain combinations of TEXT PATH and TEXT ALIGNMENT, concatenation is not meaningful and the returned concatenation point is the same as the text position. If TEXT PATH is RIGHT or LEFT, the concatenation point is displaced from the text.position, in a direction determined by the horizontal component of TEXT ALIGNMENT. If this component is LEFT, the direction is to the right; if it is CENTRE, the displacement is zero; if it is. RIGHT, the direction is to the left. Unless the horizontal component of TEXT ALIGNMENT is CENTRE, the magnitude of the displacement is the width of the text extent parallelogram plus one additional character spacing. (The width of the text extent parallelogram is the length of the sides parallel to the CHARACTER BASE VECTOR.) If TEXT PATH is UP or DOWN, the concatenation point is displaced from the text position in a direction determined by the vertical component of TEXT ALIGNMENT. If this component is TOP or CAP, the direction is down; if it is HALF, the displacement is zero; if it is BASE or BOTTOM, the direction is up. Unless the vertical component of TEXT ALIGNMENT is HALF, the magnitude of the displacement is the height of the text extent parallelogram plus an additional character spacing. (The height of the text extent parallelogram is the length of the sides parallel to the CHARACTER UP VECTOR.) Control characters in the character string have a workstation treatment in the TEXT function (see 5.3). dependent effect consistent with their

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability:
GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation identifier is invalid Specified workstation is not open Specified workstation is neither of category OUTPUT nor oj'category OUTIN 101 Invalid code in string

7 20 25 39
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Inquiry functions

E3 P CXARACTER SPACING=0 CHARACTER UP VECTOR =(O,l) TEXT PATH =RIGHT Trmr ALIGNMENT=(NOR~NORMAL) E2 CHARACTERSPACING=-0.2 CHARACTER UP VECTOR =(O,l) TEXT PATH =LEFT TEXT ALIGNMENT= (RIGHT,BASE) CHARACTER SPACING=0 ARACTER UP VECTOR =(-1.1) TEXT PATH =RIGHT TEXT ALIGNMENT=(NORMAL.NORMAL) P

CHARACTER SPACING=0.2 CHARACTER UP VECTOR =(O.l)l TEXT PATH =DOWN TEXTALIGNMENT=(LEm,TOP) CHARACTER SPACING=0 CHARACTER UP VECTOR =(O.l) TEXT PATH =UP TEXTALIGNMENT=(CENTRE,BO~TOM) P P: x c: + El,EZ, E3,E4: text position concatenation point corners of text extent rectangle, which for TEXT PATH = UP or DOWN encloses the widest character in the font

Figure 17 - Examples of replies to INQUIRE TEXT EXTENT with different text attributes
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INQUIRE LIST OF FILL AREA INDICES Parameters: In out out out workstation identifier error indicator number of fill area bundle table entries list of defined fill area indices

WSOP,WSAC,SGOP

Lla N I I nx1

(5.n) (1.n)

Effect: If the inquired information the output parameters.
.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 20 25 33 35 36 References: 4.4.6 4.11.2 Errors: none GKS not in proper state: GKS shall be in one of the states WSOP. WSAC or SGOP Spec@ed workstation. identifier is invalid Specified workstation is not open _ SpecijZed workstation is of category MI Specsed workstation is of category INPUT Spectjied workstation is Workstation litdependent Segment Storage
'

INQUIRE FILL AREA REPRESENTATION Parameters: In In In Out Out Out Out workstation ;identilier fill area index type of returned values error indicator fill area interior style fill area style index fill area colour index

WSOP,WSAC,SGOP

Lla N

(l..n) (SET,REALIZED) (HOLLOW,SOLID,PATTERN,HATCH) (-n..-l,l..n) (O..n)

4 ; I I

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the specified fill area index is not present in the fill area bundle table on the workstation and the specified type of returned values is REALIZED, the representation for fill area index 1 is returned. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability:
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7 20 25 33 35 36 80 81. References: 4.4.6 4.11.2 Errors: none

GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation identifier is invalid SpeciJed workstation is net open Specified workstation is of category MI Specified workstation is of category INPUT Specified workstation is Workstation Independent Segment Storage Fill area index is invalid A representation for the spec$edj% area index has not been defined on this workstation

INQUIRE LIST OF PATTERN INDICES Parameters: In
out out out

WSOP,WSAC,SGOP

Llr N I I nx1

workstation identifier error indicator number of pattern table entries list of pattern indices

(O..n) (I..n)

Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 20 25 33 35 36 References: 4.4.6 4.11.2 Errors: none GKS not Specified Specijied Specified Specified Specijied in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP workstation identifier is invalid workstation is not open workstafion is of category MI workstation is of category INPUT workstation is Workstation independent Segment Storage

IS:12369-1987 IS0 7942 -1985
GKS functions
.

INQUIRE PATTERN REPRESENTATION Parameters: In In In Out Out Out workstation identifier pattern index type of returned values error indicator pattern array dimensions pattern array

WSOP,WSAC,SCOP

L18 N

(l..n) (SET,REALIZED)

;

I 2x1 (I..n) (O..n) n x n x I is returned as 0 and values are returned in

Effect: If the inquired information is available, the error in&ator the output parameters.

If the specified pattern index is not present in the pattern table on the workstation and the specified type of returned values is REALIZED, the representation for pattern index 1 is returned (pattern index 1 is present if interior style PATTERN is supported on the workstation). If the inquired information is not availab!e, the values returned in the output parameters are i@e.mentation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGbP
20 SpecjFed workstation identifier is invalid

25 33 3.5 36 85 88 90 References: 44.6 4.11.2 Errors: none

Speca@ed workstation is nor open Specified workstation is of category MI Spectsed workstation is of categov INPUT SpecQied workstation is Workstation Independent Segment Storage Specajied pattern index is invalid A representation for the spectjied pattern in+x has not been defined on this workstation Interior style PATTERN is nor supported on this workstation

INQUIRE LIST OF COLOUR INDlCE!3 Parameters: In out out out workstation identifier error indicator number of colour table entries list of colour indices

wSOP,wsAc&cOP

uh N I

(2..n) (O..n)

I
nx1

Effect: If the inquired information is available, the error indicator is returned as 0 and values are retuned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP
20 Specl#ed workstation idenrzper is invalid

25 33 35 36

Specified Specified Specified Specified

workstation workstation workstation workstation

is is is is

not open of category MI of category INPUT Workstation Independent Segment Storage

.
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References: 4.4.9 4.11.2
* Errors:

none

INQUIRE COLOUR REPRESENTATION Parameters: In In In out out workstation identifier colour index type of returned values error indicator colour (red,green,blue intensities)

WSOP,WSAC,SCOP

LOa N

(O..n) (SET,REALIZED)

Ku1

I E I 3xR

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the specified colour index is not present in the colour table on the workstation and the specified type of returned values is REALIZED, the representation of the workstation dependent colour index, that `would be used if output primitives were displayed with the specified colour index, is returned. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 20 25 33 35 36 93 94 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP Specified workstation identtjier is invalid Specified workstation is not open Specified workstation is of category MI Specified workstation is of category INPUT Specified workstation is Workstation Independent Segment Storage Colour index is invalid A representation for the specified colour index has not been defined on this workstation

I

References: 4.4.9 4.11.2 Errors:
none
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INQUIRE WORKSTATION TRANSFORMATION Parameters: workstation identifier In Out error indicator Out workstation transformation update state Out requested workstation window Out current workstation window Out requested workstation viewport Out current workstation viewport Effect: If the inquired information the output parameters.

WSOP,WSAC,SGOP

LOa N

(NOTPENDING,PENDING) NDC NDC DC DC

E' 4xR 4xR 4xR 4xR

is available, the error indicator is returned as 0 and values are returned in if a workstation transformation change

The workstation transformation update state is PENDING has been requested but not yet provided.

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP
20 25 33 36 Specified Specified Specified Specified workstation workstation workstation workstation identifier is invalid is not open is of category MI is Workstation Independent Segment Storage

References: 4.6.3 4.11.2 Errors:
none

INQUIRE SET OF SEGMENT NAMES ON WORKSTATION Parameters: workstation identifier In Out error indicator Out number of segment names Out set of stored segments for this workstation Effect: If the inquired information the output parameters.

WSOP,WSAC,SGOP

Lla N I I nxN

(O..n)

is available, the error indica-tor is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are imPiementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 GKS not in proper state: GKS shall be in one of the states WSOP. WSAC or SGOP
20 25 33 35 Specified Spec$ed SpeciJied Specified workstation workstation workstation workstation identiJier is invalid is not open is of category MI is of category INPUT

References: 4.5.2 4.7.1 4.11.2
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INQUIRE LOCATOR DEVICE STATE

WSOP,WSAC,SGOP

LBb

Farameters: N In workstation identifier In locator device number (1W.p) (SET,REALI@BR) I! In type of returned values Out error indicator (REQUEST,SAMPLE,EYpNT) ; Out operating mode (ECHO,NOECHO) B Out echo switch (O..n) I Out initial normalization f4ansforrrj&n number P WC Out initial locator position p@ @li.,~lJ.Jl) I Out prompt and echo type 4xR Out echo area Out locator data record yffect: If the inquired information, is available, the error inc@&+Fis returnad 8% 0 and values are returned E the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set 1s one of the following error numbers to indicate the reason for non-availability: 7 GKS not in proper state: GKS &g# he i# ~qe @f the states WSOP, WSAC or SGOP
u) Specijied workstation 25 Specz@ed wor&tation 3% Specified wprkst@ion 140 SpeciEed &p&t device identifier is imqfid is not open is neither afcate@~ry INPUT
is not present on workstation

nor of category OUTIN

References: 4.8 4.11.2 Errors:
none
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INQUIRE STROKE DEVICE STATE Parameters: In In In out out out out out out out out out workstation identifier stroke device number type of returned values error indicator operating mode echo switch initial normalization transformation initial ,number of points initial points in stroke prompt and echo type echo area stroke data record

k
(l..n) (SBT,REALIZED) (REQUEST,SAMPLE,RVENT) (ECHO,NOECHO) (O..n) (0.n) WC ( -n..-l,l..n) DC
I

number

E I E E I I nxP I 4xR D

Effect: If the inqu, rd information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 20 `25 38 I40 References: 4.8 4.11.2 Errors: none GKS not in proper state: GKS shaN be in one of the states WSOP, WSAC or SGOP Specijied workstation ident$er is invalid Specified workstation is not open Specijied workstation is neither of category INPUT nor of category OUTIN Epect#ied input device is not present on workstation

INQUIRE VALUATOR DEVICE STATE Parameters: In In out out out out out out out workstation identifier valuator device number error indicator operating mode echo switch initial value prompt and echo type echo area valuator data record

WSOP,WSAC,SGOP N I I E E R I 4xR D

(l..n) (REQUEST,SAMPLE,EVENT) (ECHO,NOECHO) (-n..-l,l..n) DC

Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 20 25 38 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGaP SpeciJied workstation identifier is invalid Spec$ed workstation is not open Spec$ed workstation is neither of category INPUT nor of category OUTIN 149
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GKS functions
input device is not present on workstation

References: 4.8 4.11.2 Errors: none

INQUIRE CHOICE DEVICE STATE Parameters: In In out out out out out out out out workstation identifier choice device number error indicator operating mode echo switch , initial status initial choice number prompt and echo type echo area choice data record

WSOP,WSAC,SGOP

LOb N I I E E E I I 4xR D

(l..n) (REQUEST,SAMPLE,EVENT) (ECHO,NOECHO) (OK,NOCHOICE) (l..n) (-n..-l,l..n) DC

Elfect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 20 25 38 140 References: 4.8 4.112 Errors:
none

GKS not SpeciJied SpeciJied Specified Specified

in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP workstation identifer is invalid workstation is not open workstation is neither of category INPUT nor of category OUTIN input device is not present on workstation
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INQUIRE PICK DEVICE STATE Parameters: Iu In In out out out out out out out out out workstation identifier pick device number type of returned values error indicator operating mode echo switch initial status initial segment initial pick identifier prompt and echo type echo area pick data record

N `(l..n) (SET,REALIZED) (REQUEST,SAMPLE,EVENT) (ECHO,NOECHO) (OK.NOPICK) ; E' E E N N I 4xR D

(-n..-l,l..n) DC
,

,

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 GKS not in proper state: GKS shall be in one of the states WSOP,
20 25 37 140 Specijed SpeciJied Specified Specijied workstation workstation workstation input device identifier is invalid is not open is not of category OUT/N is not present on workstation WSAC or SGOP

References: 4.8 4.11.2 Errors: none

INQUIRE STRING DEVICE STATE

WSOP,WSAC,SGOP

Lob

Parameters: In In out out out out out out out workstation identifier string device number error indicator operating mode echo switch initial string prompt and echo type echo area string data record (l..n) (REQUEST,SAMPLE,EVENT) (ECHO,NOECHO) (-n..-l,l..n) DC N I I E E S I 4xR D

Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability:
7 20 -75 38 GKS not Spec$ed Specified Sprc&d in proper state: GKS shall be in ww qf thr states WSOP, WSAC or SGOP 9 workstation ident$er is invalid workstation is ttot open workstation is neither qf category INPUT nor of' category OUTIN 151
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Inquiry functions 140 Specified input device is not present on workstation References: 4.8 4.11.2 Errors: none 5.9.6 Inquiry functions for workstation description table INQUIRE WORKSTATION CATEGORY Parameters: In Out Out workstation type error indicator workstation category N (OUTPUT,INPUT,OUTIN,WISS,MO,MI) ; GKOP,WSOP,WSAC,SGOP Loa
\ GKS

functions

,

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP. WSAC or SGOP 22 Specified workstation type is invalid 23 Specified workstation type does not exist References: 4.5.1 4.11.2 Errors: none

INQUIRE WORKSTATION CLASSIFICATION Parameters: In Out Out workstation type error indicator vector, raster, or other type

GKOP,WSOP,WSAC,SGOP

LQa N

(VECTOR,RASTER,OTHER)

;

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 39 References: 4.5.1 4.11.2 GKS not Specified Specified Specified in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP workstation type is invalid workstation type does not exist workstation is neither of category OUTPUT nor of category OUTIN
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INQUIRE DISPLAY SPACE SIZE Parameters: In out out out out workstation type error indicator device coordinate units display space size in device coordinate units display space size in raster units

GKOP,WSOP,WSAC,SGOP

Loa N

(METRES,OTHER) DC (I*?;

; 2xR 2x1

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 31 33 36 References: 4.5.1 4.11.2 Errors: none GKS nol Specified Specified Specified Spectjied Specified in proper state: GKS shall be in one of the states GKOP. WSOP, WSAC or SGOP workstation type is invalid workstation type does not exist workstation is of category MO workstation is of category MI workstation is Workstation Independent Segment Storage

INQUIRE DYNAMIC MODIFICATION Parameters: In out out out out out out out out

OF WORKSTATION

ATTRIBUTES GKOP,WSOP,WSAC,SGOP

Lla N I E E E E E E E

workstation type error indicator polyline bundle representation changeable polymarker bundle representation changeable text bundle representation changeable fill area bundle representation changeable pattern representation changeable colour representation changeable workstation transformation changeable

(IRG,IMM) (IRGJMM) (IRG,IMM) (IRGJMM) (IRG,IMM) (IRG,IMM) (IRG,IMM)

Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. ,IRG means that implicit regeneration is necessary; IMM means the action is performed immediately. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 GKS not in proper state: GKS shall be in one of the states GKOP, 22 Specified workstation type is invalid
WSOP, WSAC or SGOP
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Inquiry functions 23 Specljied 39 Specified workstation workstation type does not exist is neither of category

GKS functions

OUTPUT

nor of category

OUTIN

References: 4.5.1 4.5.3 4.11.2 Errors:
none

INQUIRE DEFAULT DEFERRAL STATE VALUES Parameters: In out out out workstation type error indicator default value for deferral mode default value for implicit regeneration mode

GKOP,WSOP,WSAC,SGOP

Lla

N (ASAP,BNIG,BNIL,ASTI) (SUPPRESSED,ALLOWED) ; E

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the, inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 GKS not 22 Specified 23 Specified 39 Specified References: 4.5.1 4.5.3 4.11.2 Errors: none
in proper state: GKS shall be in one of the states GKOP. WSOP. WSAC or SGOP workstation type is invalid workstation type does not exist workstation is neither of category OUTPUT nor of category OUTIN

INQUIRE POLYLINE Parameters: In out out out out out out out

FACILITIES

GKOP,WSOP,WSAC,SGOP

LOa N

workstation type error indicator number of available linetypes list of available linetypes number of available linewidths nominal linewidth` range of linewidths (minimum.maximum) number of predefined polyline indices

(4..n) (-n..-l,l..n) (0.n) >o DC ro DC (5.n)

I I nxI I R 2xR I

Effect: If the inquired information the output parameters.

is available. the error indicator is returned as 0 and values are returned in

If the number of available linewidths is returned as 0, the workstation supports a continuous range of linewidths.
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If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 39 References: 4.5.1 4.11.2 Errors: none GKS not SpeciJied Specified Specified in proper state: GKS shall be in one of the states GKOP. WSOP, WSAC or SGOP workstation type is invalid workstation type does not exist workstation is neither of category OUTPUT nor of category OUTIN

INQUIRE PREDEFINED POLYLINE REPRESENTATION

GKOP,WSOP,WSAC,SGOP

L&a

Parameters: In In Out Out Out Out workstation type predefined polyline index error indicator linetype linewidth scale factor polyline colonr index (l..n) (-n..-l,l..n) (O..n) N I I I R I

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the folIowing error numbers to indicate the reason for non-availability: 8 22 23 39 60 62 References: 4.5.1 4.11.2 Errors: none GKS not in proper state: GKS shall be in one of the states GKOP. WSOP, WSAC or `SGOP S'c@ed workstation type is invalid Specified workstation type does not exist Specified workstation is neither of category OUTPUT nor of category OUTIN Polyiine indpx is invalid A representation for the spectjied polyline in&x has not been preeed on this workstation

IS:12369-1987 ISO 7942 - 1985 mmINQUIRE POLYMARKKR Parameters: In Out Out out out out Out Out
workstation type

GKSfrnctiolls FACILITIES GKOP,WSOP,WSAC,SGOP LOa N I I nx1 I R 2xR I

error indicator number of available marker types list of available marker types number of available marker sizes nominal marker sire range of marker sires (minimum,maximum) number of prede6ned polymarker indices

(5.n) (-n..-l,l..n) (O..n) DC >o DC (5.Z;

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the number of available marker sires is returned as 0, the workstation supports a continuous range of marker sizes. If the inquired information is not available, the values retu*med in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 GKS not 22 Specijced 23 Specljied 39' Spec$ed References: 4.5.1 4.11.2 Rrrors: ?wne in proper state: GKS shall be in one of the states GKOP. WSOP. WSAC or SGOP workstation (ype is invalid workstation type does not exist workstation is neither of category OUTPUT nor of category OUTIN

INQUIRE PREDEFINED Parameters:

POLYMARKER

REPRESENTATION

GKOP,WSOP,WSAC,SGOP

Lo1 N I I I R I

In workstation type In predetined polymarker index ' Out error indicator Out marker type Out marker size scale factor out polymarker colour index Effect: If the inquired information the output parameters.

(l..n) (-n..-l,l..n) (O..n)

is available, the error indicator is returned as D and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 39 66 68 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP Specijed workstation type is invalid Specified workstation type does not exist Specified workstation is neither of category OUTPUT nor of category OUTIN Polymarker index is invalid A representation for the specified polymarker index has not been predejned on this wqkstation
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INQUIRE TEXT FACILITIES Parameters: In
out out out out out out out out

CKOP,WSGP,WSAC,SGGP

Lo1

N workstation type I error indicator (l..n) I number of text font and precision pairs (-n..-l,l..n;STRING,CHAR,STROKE) n x (I;E) list of text font and precision pairs (O..n) I number of available character heights 2xR DC range of character heights (minimum,maximum) (0.Y: I number of available character expansion factors 2xR range of character expansion factors (minimum,maximum) (2.L: I number of predegned text indices

Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the number of available character heights is returned range of character heights. If the number of available the workstation supports a continuous range of character heights and character expansion factors vary between expansion factors returned are for font 1. as 0, the workstation supports a continuous character expansion factors is returned as 0, expansion factors. If the available character fonts, the character heights and character

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 39 References: 4.5.1 4.11.2 Errors: none GKS not Speclfled Spe@ed Specified in proper state: GKS shall be in one of the states GKOP, WSOP. WSAC or SGOP workstation type is invalid workstation type does not exist workstation is neither of category OUTPUT nor of category OUTIN
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funetioas
TEXT REPRESENTATION

GKS functions GKOP,WSOP,WSAC,SGOP LOa N I (13; R R I

INQUIRE PREDEFINED Parameters: In In Out Out Out Out Out

workstation type predefined text index error indicator text font and precision character expansion factor character spacing text colour index

(1.n) (-xi..-l,l..n;STRING,CHAR,STROICE) >o (O..n)

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 39 72 74 References:
4.5.1

GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or #GOP Specified workstation type is invalid Specified workstation type does not exist Specified workstation is neither of category OUTPUT nor of category OUTIN Text index is invalid A representation for the spec$ed text index has not been predefied on this workstation

4.11.2 Errors: none

INQUIRE FILL AREA FACILITIES Parameters: In Out Out Out Out Out Out workstation type * error indicator number of available fill area interior styles list of available fill area interior styles number of available hatch styles list of available hatch styles number of predefined fill area indices

GKOP,WSOP,WSAC,SGQP

L&I N I

(l..n) (HOLLOW,SOLID,PATTERN,HATCH) (O..n) (-n..-l,l..n) (5.n)

nxi I nx1 I

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 39 References: 4.5.1 4.11.2 GKS not Specified Specified Specified in proper .state: GKS shal! be in one of the states GKOP, WSOP, WSAC or SGOP workstation type is invalid workstation (vpe does not exist workstation is neither of category OUTPUT nor of category OUTIN
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INQUIRE PREDEFINED Parameters: In In Out Out Out Out

FILL AREA REPRESENTATION

GKOP,WSOP,WSAC,SGOP

LOa N I : I I

workstation type predefined fill area index error indicator fill area interior style fill area style index fill area colour index

(l..n) (HOLLOW,SOLID,PATTERN,HATCH) (-n..-1,l.n) (O..n)

/

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 39 80 82 References: 4.5.1 4.11.2 Errors: GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGGP Specified workstation type is invalid Specified workstation type does not exist Specified workstation is neither of category OUTPUT nor of category OUTIN Fill area index is invalid A representation for the specifiedjSl1 area index has not been predejined on this workstation

INQUIRE PATTERN FACILITIES Parameters: In out out workstation type error indicator number of predefined pattern indices

GKOP,WSOP,WSAC,SGOP

LOa N I I

(O..n)

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 39 References: 4.5.1 4.11.2 GKS not Specified Specified Specified in proper state: GKS shafl be in one qf the states GKOP, WSOP, WSAC or SGOP workstation type is invalid workstation type does not exist workstation is neither of category OUTPUT nor of category OUTiN
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Errors:
none

GKS functions

INQUIRE PREDEFINED Parameters: In In out out out

PATTERN REPRESENTATION

GKOP,WSOP,WSAC,!ZOP

LOa

workstation type predefined pattern index error indicator pattern array dimensions `pattern array

(1.n)

N I I (l..n) 2x1 (O..n) n x n x I

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 39 85 89 90 References: 4.5.1 4.11.2 Errors: none
GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP Specljied workstation type is invalid Specified workstation type does not exist Specified workstation is neither of category OUTPUT nor of category OUTIN Specified pattern index is invalid A representation for the specified pattern index has not been predejined on thii workstation Interior style PATTERN is not supported on this workstation

INQUIRE COLOUR FACILITIES Parameters: In out out out out workstation type error indicator number of available colours or intensities colour available number of predefined colour indices

GKOP,WSOP,WSAC,SGOP

LOa N I

(0,2..n) (COLOUR,MONOCHROME) (2.n)

F! I

Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the number of available colours or intensities is returned as 0, the workstation supports a continuous range of colours or intensities. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 GKS not in proper state: GKS shaN be in one qf the states GKOP. WSOP. WSAC or SGOP 22 Specified workstation type is invalid 23 Specljied workstation type does not exist . 39 Specified workstation is neither of category OUTPUT nor qf categorv OUTIN
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References: 4.5.1 4.11.2 Errors:

INQUIRE PREDEFINED Parameters: In In out out

COLOUB REPRESENTATION

GKOP,WSOP,WSAC,SGOP

LOa

workstation type predefined colour index error indicator colour (red, green, blue intensities)

(On)

[WI

N I I 3xR

Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 39 93 95 References: 4.51 4.11.2 Errors: none GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP Specified workstation type is invalid Specified workstation type does not exist Specified workstation is neither of category OUTPUT nor of category OUTIN Colour index is invalid A representation for the specified colour index has not been predejined on this workstation

INQUIRE LIST OF AVAILABLE GENERALIZED

DRAWING PRIMITIVES GKOP,WSOP,WSAC,SGOP

Ma

Parameters: In out out out workstation type error indicator number of available generalized drawing primitives list of GDP identifiers N I I nxN

(O..n)

Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 39 GKS not Specifed Spectjied Spec$ed in proper state: GKS shalI be in one of the states GKOP, WSOP, WSA'C or SGOP . workstation type is invalid workstation type does not exist workstation is neither of category OUTPUT nor of category OUTIN
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INQUIRE GENERALIZED DRAWING PRIMITIVE Parameters: In In out out out workstation iype GDP identifier error indicator number of sets of attributes used list of sets of attributes used

GKOP,WSOP,WSAC,SGOP

LOa
N

N
I

(POLYLINE,POLYMARKER,TEXT,FILL

(0..4) AREA)

I nxE

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 GKS not in proper state: GKS shall be in one of the states GKOP,
22 23 39 41 Specified Spec$ed Specijied Specrfied workstation workstation workstation workstation WSOP, WSAC or SGOP type is invalid type does not exist is neither of category OUTPUT nor of category OVTIN type is not able to generate the specified generalized drawing primitive

References:
4.5.1

4.11.2 Errors:
none

INQUIRE MAXIMUM LENGTIji OF WORKSTATION STATE TABLES GKOP,WSOP,WSAC,SGOP Parameters: In
out out out Out Out Out out

workstation type error indicator maximum number maximum number maximum number maximum number maximum number maximum number

of of of of of of

polyline bundle table entries polymarker bundle table entries text bundle table entries fill area bundle table entries pattern indices colour indices

(5.n) (5.n) (2..n) (5.n) (O..n) (Z..n)

N I I I I I I I

EKiZCt:If Lhe inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the ihquired information is not available, the values returned in the output parameters are implementation derjendent and the error indicator is set to one of the following error numb&s to indicate the reason for non-availability:
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GKS feaetbns 8 22 23 39 References: 4.5.1 4.11.2 Errors: none GKS not Specijied SpecijiPd Specified Inqlliry functions in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP workstation type is invalid workstation type does not exist workstation b neither of category OUTPUT nor of category OUT/N

INQUIRE NUFdBER OF SEGMENT PRIORI'MES SUPPORTED Parameters: In workstation type Out error indicator Out number of segment priorities supported

GKOP,WSOP,WSAC,SGOP

Lla N I I in

(O..n)

Effect: If the inquired information is available, the error indicator is returned as 0 and values are retuned the output parameters. If the number of segment priorities supported is returned as 0, the workstation number of segment priorities.

supports an infinite

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 39 References: 4.5.1 4.7.2 4.11.2 Errors: none GKS not Spectjied Specijied Specified in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP workstation type is invalid workstation ?vpe does not exist workstation is neither of category OUTPUT nor of category OUTIN
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GKS functions OF SEGMENT ATTRIBUTES GKOP,WSOP,WSAC,SGOP

INQUIRE DYNAMIC MODIFICATION Parameters: In Out Out Out Out Out Out Out Out

Lh

workstation type error indicatar segment transformation changeable visibility changeable from `visible' to `invisible' visibility changeable from `invisible' to `visible' highlighting changeable segment priority changeable adding primitives to the open segment segment deletion immediately visible

N
(IRGJMM) (IRG,IMM) (IRG,IMM) (IRG,IMM) (IRGJMM) (IRG,IMM) (IRGJMM) : E E E E E E

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

IRG means that implicit regeneration is necessary; IMM means the action is performed immediately. If the inquired information is not available, the values Tetumed in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 GKS not 22 Specified 23' Spec@ed 39 Specijied References: 4.5.1 4.5.3 4.11.2 Errors: in proper St&e: GKS shall be in one of the states GKOP. WSOP, WSAC or SGOP workstation type is invalid workstation type does not exist workstation is neither of category OUTPUT nor of category OVTIN

none

INQUIRE NUMBER OF AVAILABLE LOGICAL INPUT DEVICES GKOP,WSOP,WSAC,SGOP Parameters: In out out out out out out out workstation type error indicator number of locator devices number of stroke devices number of valuator devices number of choice &vices number of pick devices number of string devices

Lob

N
(O..n) (O..n) (O..n) (0-n) (O..n) (O..n) I I I I I I .I

Elfect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 38 GKS not Specified Spec#ied Spec$ed in proper state: GKS shall he in one of the states GKOP, WSOP, WSAC or SGOP l workstation type is invrtlid worksta tiou rvpr does mt rsisr workstutioa i.vn&b of cutego~~ IIZ'PL'Tnor 01'cutegot-?* OUTIN

164

IS:12369

-1987

IS0 7942 - 1985 CKS functions References: 4.5. I 4.8.1 4.11.2 Errors:
Inquiry functions

INQUIRE DEFAULT LOCATOR DEVICE DATA Parameters: In In Out Out Out Out Out Out workstation type logical input device number error indicator default initial locator position number of available prompt and echo types list of available prompt and echo types default echo area default locator data record
.

CKOP,WSOP,WSAC,SGOP

Lob N I I P I nx1 4xR D

(l..n) WC (l..n) (-n..-l,l..n) .DC

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 38 140 References: 4.5.1 4.8.1 4.8.6 4.11.2 Errors: none GKS not Specified Specified Specified Specified in proper state: GKS shall be in one of the states GKOP. WSOP, WSAC or SGOP workstation type is invalid workstation type does not exist workstation is neither of category INPUT nor of category OUTIN input device is not present on workstation

IS:12369-1987 IS0 7942 - 1986
Inquiryhlctioas

GKS fmmtths

INQUIRE DEFAULT STROKE DEVICE DATA Parameters: In In out out out out out out workstation type logical input device number error indicator maximum input buffer size number of available prompt and echo types list of available prompt and echo types default echo area default stroke data record

GKOP,WSOP,WSAC,SGOP
N (Ln)

(64.n) (l..n) (-n..-l,l..n) DC

I I I I nx1 4xR D

Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 38 140 References: 4.5.1 4.8.1 4.8.6 4.11.2 Errors:
none

GKS not Specified Specified Sgecifed Specified

in proper state: GKS shall be in one of the states GKOP, WSOP. WSAC or SGOP workstation type is invalid workstation type does not exist workstation is neither of category lNPi_JT nor of category OUTIN input device is not present on workstation

INQUIRE DEFAULT VALUATOR DEVICE DATA Parameters: In In out out out out out out workstation type logical input device number error indicator ' default initial value number of available prompt and echo types list of available prompt and echo types default echo area default valuator data record
N

(l..n)

(l..n) (-n..-l,l..n) DC

I I R I nx1 4xR D

Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 22 23 38 140 GKS not Specified Specified Spec$ied
Swcifkd

in proper state: GKS shall be in one of the states GKOP, WSOP, WSACI or SGOP , workstation type is invalid workstation type does not exist ' workstation is neither qf cutegor), INPUT nor qf category OUTIN
inmt device is not mesent on workstation
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INQUIRE DEFAULT CHOICE DEVICE DATA Parameters: In It3 out out out out out out workstation type logical input device number error indicator maximum number of choice alternatives number of available prompt and echo types list of available prompt and echo types default echo area default choice data record

GKOP,WSOP,WSAC,SGOP N I I I I nxI 4xR D

(1.3) (1.n) (1.n) (-n..-l,l..n) DC

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: GKS not Speczjied Specified Specilfed 140 Specified References: 4.5.1 4.8.1 4.8.6 4.11.2 Errors: none 8 22 23 38 in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP workstation type is invalid workstation type does not exist workstation is neither of category INPUTnor of category OUTIN input device is not present on workstation
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GKS functions CKOP,WSOP,WSAC,SGOP Llb N I I I nx1 4xR D

INQUIRE DEFAULT PICK DEVICE DATA Parameters: In In
out Out out out out

workstation type logical input device number error indicator number of available prompt and echo types list of available prompt and echo types default echo area default pick data record

(l..n) (l..n) (-n..-l,l..n) DC

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information _is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC or SGOP 22 Specified workstation type is invalid 23 Specified workstation type does not exist 38 Specijied workstation is neither of category INPUT nor of category OUTIN 140 Specified input device is not present on workstation References: 4.5.1 4.8.1 4.8.6 4.11.2 Errors:

INQUIRE DEFAULT STRING DEVICE DATA Parameters: In In out out out out out out workstation type logical input device number error indicator maximum string buffer size number of available prompt and echo types list of available prompt and echo types default echo area default s&g data record

GKOP,WSOP,WSAC,SGOP

LOb N I I I I nx1 4xR D

(l..n) (72..n) (I..n) (-n..-l,l..n) DC

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 8 GKS not in proper state: GKS shall bc in one qf the states GKOP. WSOP. WSAC or SGOP
22 23 38 140 Specified Specified Specijied Spec$ed workstation workstation workstation input device t_ypeis invalid type does not exist is neither qf categocv INPUT nor qf category OUTIN
is not present on workstcttion
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GKS functions References: 4.5.1 4.8.1 4.8.6 4.11.2 Errors: none 5.9.7 Inquiry functions for segment state list INQUIRE SET OF ASSOCIATED WORKSTATIONS Parameters: In out out out segment name error indicator number of associated workstations set of associated workstation identifiers

Inquiry functions

WSOP,WSAC,SGOP

Lla N I I nxN

(l..n)

Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP 120 Specified segment name is invalid 122 Speci$ed.segment does not exist References: 4.7 4.11.2 Errors: none

INQUIRE SEGMENT ATTRIBUTES Parameters: In out out out out out out segment name error indicator segment transformation visibility highlighting segment priority detectability

WSOP,WSAC,SGOP

Lla N I

matrix (VISIBLE,INVISIBLE) (NORMAL,HIGHLIGHTED)

2x3xR E E

P,ll
(UNDETECTABLE,DETECTABLE)

R
E

Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the inquired information is not available, the values returned in the output parameters,are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP 120 Specified segment name is invalid 122 Spec$ed segment does not exist
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Impiry fuaetioas References: 4.7 4.11.2 Errors: none 5.9.8 pixel ioquiries INQUIRE PIXEL ARRAY DIMENSIONS Parameters: In In out out workstation identifier 2 points P,Q error indicator dimensions of pixel array WC (1.3) N 2xP I 2x1 WSOP,WSAC,SCOP GKS famdioas

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

The points P,Q define a rectangle. By transforming P and Q by the current normalization and workstation transformations, the rectangle is mapped onto the display surface. The number of columns and the number of rows of pixels, whose positions lie within the rectangle, are returned. For this calculation no clipping is applied. If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 20 25 39 References: 4.11.2 Errors: none GKS not Specified Specified Specified in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP workstation identifier is invalid workstation is not open workstation is neither of category OUTPUT nor of category OUTIN

*

INQUIRE PIXEL ARRAY Parameters: In In In out out out workstation identifier point P dimensions of colour index array DX,DY error indicator presence of invalid values colour index array

WSOP,WSAC,SGOP

LQa

N P (l..n) 2x1 I (ABSENT,PRESENT) E (-l..n) nxnxl WC

Effect: If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. By transforming P by the current normalization and workstation transformations. it is mapped onto a pixel of the display surface. The colour indices of the array of pixels, whose upper left comer is this pixel (associated with the (1,l) element), are returned in the colour index array. The ocentation of the array is such that the first dimension increases as the X device coordinate increases and the second dimension increases as the Y device coordinate decreases. If the colour index corresponding to a particular pixel cannot be ascertained (for example. the point P was transformed such that the position of 170
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the pixel is not on the display surface), the value -I (i.e. invalid) is assigned for that cell. If the inquired information is not available, the values returned in the output parameters are impleentation dependent and the error indicator is set to one of the following error numbers to indicate reason for non-availability: 4 `7 GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP 20 Spectfied workstation identifier is invaiid 25 Spectfied workstation is not open 39 Specified workstation is neither of category OUTPUT nor of category OUTIN 40 Spectfied workstation has no pixel store readback capability 91 Dimensions of colour array are invalid References: 4.11.2 Errors: none

INQUIRE PMEL Parameters: In In out out workstation identifier point P error indicator colour index .

WSQP,WSAC,SGQP

LOa N P I I

WC (-l..n)

Effect: If the inquired information the output parameters.

is available, the error indicator is returned as 0 and values are returned in

By transforming P by the current normalization and workstation transformations, it is mapped onto a pixel of the display surface. The colour index of this pixel is returned. If a colour index cannot be ascertained (for example, the point P was transformed such that the position of the pixel is not on the display surface), the value -1 (i.e. invalid) is returned! If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 20 25 39 40 References: 4.11.2 Errors: none GKS not Specified Specified Specifed Specified in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP workstation identtfier is invalid workstation is not open workstation is neither of category OUTPUT nor of category OUTIN workstation has no pixel store readback capability

171

IS i 12369 - 1987 IS07942 - 1986
Inquiry f8inctions 5.9.9 Inquiry fmmion for GKS error state list INQUIRE INPUT QUEUE OVERFLOW Parameters: Out error indicator Out workstation identifier Out input class Out logical input device number Effect: If the inquired information the output parameters. I N E I WSOP,WSAC,SGOPI LOc GKS functions

(LOCATOR,STROKE,VALUATOR,CHOICE,PICK,STRING) (l..n)

is available, the error indicator is returned as 0 and values are returned in

If the input queue has overflowed since OPEN GKS or the last invocation of INQUIRE INPUT QUEUE OVERFLOW, the identification of the logical input device that caused the overflow is returned. The eptry is removed from the error state list. If the inquired information is not available, the values retume,d in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability: 7 GKS not in proper state: GKS shall be in one ofthe states WSOP, WSAC or SGOP 148 Input queue has not overflowed since GKS was opened or the last invocation of INQUIRE INPUT QUEUE OVERFLOW 149. input queue has overflowed, but associated workstation has been closed References: 4.8.5 4.11.2 Errors: none
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utility functions

5.10 Utility functions
EVALUATE TRANSFORMATION MATRIX Parameters: In In In In In out fixed point shift vector rotation angle in radians (positive if anticlockwise) scale factors coordinate switch segment transformation matrix WC or NDC WC or NDC P 2xR R 2xR (WC,NDC) E 2x3xR GKOP,WSOP,WSAC,SGOP Lla

Effect: The transformation defined by Iixed point, shift vector, rotation angle, and scale factors is evaluated and the result is put in the output segment transformation matrix (for use, for example, by INSERT SEGMENT and SET SEGMENT TRANSFORMATION). The coordinate switch determines whether the shift vector and Iixed point are given in WC coordinates or NDC coordinates. If WC coordinates are used, the shift vector and the fixed point are transformed by the current normalization transformation. The order of transformation is: scale, rotate (both relative to the specified fixed point), and shift. The elements Mis and M2s of the resulting 2 x 3 transformation matrix are in NDC coordinates; the other elements are unitless. References: 4.7,3 Errors: 8 GKS not in proper state: GKS shall be in one of the states GKOP. WSOP. WSAC or SGOP

ACCUMULATE TRANSFORMATION MATRIX Parameters: In In In In In In out segment transformation matrix ' I'Ixedpoint shift vector rotation angle in radians (positive if anticlockwise) scale factors coordinate switch segment transformation matrix

GKOP,WSOP,WSAC,SGOP

Lla 2x3xR

WC or NDC WC or NDC

P 2xR R 2xR (WC,NDC) E 2x3xR

Effect: The transformation defined'by tied point, shift vector, rotation angle, and scale factors is composed with the input segment transformation matrix and the result is returned in the output segment transformation matrix (for use, for example, by INSERT SEGMENT and SET SEGMENT TRANSFORMATION). The coordinate switch determines whether the shift vector and tied point are given in WC coordinates or NDC coordinates. If WC coordinates are used, the shift vector and the fixed point are transformed by the current normalization transformation. The order of transformation is: specified input matrix, scale, rotate (both relative to the specified tied point), and shift. The elements M 1s and M23 of the 2 x 3 input matrix and the resulting 2 x 3 transformation matrix are in NDC coordinates; the other elements are unitless. References: 4.7.3 Errors: 8 GKS not in proper state: GKS shall bc in one of the states GKOP, WSOP, WSAC or SGOP *

173

IS: 12369-1987 IS0 7942 - 1986
Error handling
5.11 Error handling

CK!3hdio11~

EMERGENCY CLOSE CKS Parameters: none

CKCL,CKOP,WSOP,WSAC,SGOP

LOa

Effect: GKS is emergency closed (see 4.12). The following actions are performed (if possible): a) CLOSE SEGMENT (if open); b) UPDATE for all open workstations; c) DEACTIVATE e) CLOSE GKS. This function may be called even if the error state is ON. If GKS is already closed (operating state GKCL), no action is taken. References: 4.12 Errors: none all active workstations; d) CLOSE all open workstations;

ERROR HANDLING Parameters: In In In error number as listed in annex B identification of the GKS procedure called by the application program which caused the error detection error file

GKCL,GKOP,WSOP,WSAC,SGOP

LOa I N N

NOTE - The last parameter has been defined in OPEN GKS.

Effect: The ERROR HANDLING procedure is called by GKS in any of the error situations listed in annex B. The standard procedure just calls the ERROR LOGGING procedure with the same parameters.
NOTE - The ERROR HANDLING procedure may be replaced by an application program supplied procedure to-alinw specific reaclion to some krror situations.

References: ' 4.12 Errors:
none

i

ERROR LOGGING Parameters: In In In error number as listed in annex B identification of the GKS procedure called by the application program which caused the error detection error file

GKCL,GKOP,WSOP,WSAC,SGOP

LOa
I N N

9

NOTE - The lusl parameter has been detined in OPEN GKS.
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fimetins
procedure: a) prints an error message and GKS function identification on the error file; b) returns to the calling procedure.

Effect: The ERROR LOGGING

References: 4.12 Errors: none
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6 CKS data structures

6.1 Notation and data types
In this clause, the contents of the GKS data structures are listed. The information for each entry includes a) the name of the entry; b) the coordinate system (if appropriate); c) the permitted values; d) the data type; e) the initial value (if appropriate). The notation used to express the data type, coordinate the parameters of the GKS functions in clause 5. system and permitted values is also used to describe

The data type can be a simple type, which is one of the following: I R S P integer real string' point whole number floating point number number of characters and character sequence 2 real values specifying the x- and y-coordinates of a location in WC, NDC or DC space identification (used for error file, workstation identifier, connection identifier, workstation type, specific escape function identification, GDP identifier, pick identifier, segment name and identification of a GKS function). In a programming language, not all these instances of the name data type need be bound to the same data type in the language. a data type comprising a set of values. The set is defined by enumerating the identifiers which denote the values. This type could be mapped, for example, onto scalar types in Pascal, or onto integers in FORTRAN.

N name

E enumeration

type

Alternatively, the data type can be a combination of simple types, thus f) a vector of values, for example, 2 x R g) a matrix of values, for example, 2 x 3 x R h) a list of values of one type: the type can be a simple type or a vector, for example, n x I and n x 4 x R i) an array of values of simple type, for example, n x n x I j) an ordered pair of different types, for example, (1;E) or it can be: D data record a compound data type, the content and structure of which are not defined in this International Standard.

An occurrence of n merely indicates a variable integer value and does not necessarily relate to other occurrences of n. How these data types are represented in a given implementation is dependent on the features of the programming language and on the capabilities of the system. Each language dependent layer has to map the GKS data types onto the data types available in the programming language. For coordinate data. the relevant coordinate system is indicated
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k)WC

: world coordinate

system;

1) NDC : normalized device coordinate system; m) DC : device coordinate systems. See 4.3 for more information about coordinate systems in GKS. It should be pointed out that different coordinate systems may be used in a function call and in the state lists to describe the same entry. Permitted values can be specified by n) a condition, for example, >O or [O,l]; the latter implies that the value lies between 0 and 1 inclusively; o) a standard range of integer values, for example, (1..4); p) a range of integer values in which the maximum is determined by implementation or other constraints, for example (32..n). An occurrence of n does not necessarily imply any relationship with other occurrences of n: n merely denotes a variable integer in this context; q) a list of values which constitute an enumeration type, for example, (SUPPRESSED,ALLOWED); r) an ordered list of any of the above. Initial values, if present, occur on the last column of the data structure lists. The following abbreviations Occllr: s) undef: undefined value; t) i.d: implementation dependent; u) w.d.t: initial value taken from workstation description table. If no initial value is given, the value is set by the relevant GKS function.
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6.2 Operating state
Operaling slate value (static variable) (GKCL,GKOP.WSOP,WSAC.SGOP) E GKCL
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6.3 GKS description table
level of GKS number of available workstation types list of available workstation types `maximum number of simuhaneously open workstations maxinpm number of simultaneously active workstations maximum number of workstations associated with a segment maximum normalization transformation number (I..n) (I..n) (I..n) (I.40 (Oa.Ob.Oc,la.lb,lc.2a.2b.2c) E I nXN 1 i.d i.d i.d i.d i.d i.d i.d

.

(l..n)

I I
I
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6.4 GKS state list
set

of open workstations (I..n) (-n..-l,l..n) 20 (O..n)
(BUNDLEDJNDIVIDUAL)

nXN nXN I I R I E E E I 1 R 1 E E I

empty empty I I I.0 I see the note see the note see the note I 3 I.0 I seethenote see the note

set of active workstations
current polyline index current linelype current linewidth scale factor current polyline colour index current linetype ASF current linewidth scale factor ASF current polyline colour index ASF current polymarker index current marker type current marker size scale factor current polymarker colour index current marker `type ASF current marker sixe scale factor ASF current polymarker colour index ASF current text index current text font and precision current character expansion factor current character spacing current text colour index current text font and precision ASF current character expansion factor ASF current character spacing ASF current text colour index ASF current character height current character up vector current character width current character base vector current text path current text alignment (horizontal and vertical) (NORMAL,LEFT,CENTRE,RIGHT:NORMAL,TOP,CAP,HALF,BASE,BO~OM) current fill area index current fill area interior style ' current III1area style index current fill area colour index current fill area interior styk ASF current fill area style index ASF current fill area colour index ASF current pattern width vector current pattern height vector. current pattern reference current pick identifier (l..n) (HOLLOW,SOLID,PATTERN,HATCH) (-n..-l,l..n) (O..n) (BUNDLEDJNDIVIDUAL) (BUNDLED,INDIVIDUAL) (BUNDLED.INDIVIDUAL) WC WC (O..n) (BUNDLEDJNDIVIDUAL) (BUNDLEDJNDIVIDUAL) (BUNDLED,INDIVIDUAL) (BUNDLED,INDIVIDUAL) WC WC WC WC (RIGHT,LEFT,UP,DOWN) >o >O
(BUNDLEDJNDWDUAL)

(BUNDLEDJNDIVIDUAL) (BUNDLEDJNDIVIDUAL) (I..n) (-n..-l,l..n) 20
(O..n)

(BUNDLEDINDIVIDUAL) (BUNDLEDINDIVIDUAL) (In) (-n..-I.1 ..n;STRING,CHAR,STROKE) >o

E `see the note

I
I;STRING 1.0 0.0 I see the note see thenote see the note see the note 0.01 0.1 0.01 l,O RIGHT

W3
R R I E E E E R 2xR R 2XR E 2XE

(NORMAL;NORMAL) 1 I E HOLLOW

I
I E E E 2XR 2XR P N

I I see the note see the note see the note 1.0 0.1 (0.0)

poinl

WC

current normalization transformation

number

(0.n)

language binding dependent I 0

list of normalization transformations ordered by viewport input priority (initially in numerical order with 0 highest), for every enlry: normalization transformation window viewport clipping indicator clipping rectangle name of open segment number WC NDC
KLIP.NOCLIP) NDC 4xR N

(O..n)

I entry number 4.x R 4xR
E

0. I .O,I 0. I .o. I
CLIP 0. I .o, I

undef
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set of segmenl names in use se1 of segment state lisls (one state list for every segment: see 6.7) input queue (one entry for each for every entry: workstation identifier device number last of group of simullaneous events (a single event is indicated by LAST) input class if LOCATOR normalization transformation position if STROKE normalization transformation number of points points in stroke if VALUATOR value if CHOICE slalus choice number if PICK status segment name pick identifier if STRING string current even1 report containing: input class if LOCATOR normalization transformation position if STROKE normalizalion transformation number of points points in stroke if VALUATOR value if CHOICE status choice number if PICK slatus segment name pick identifier if STRING string more simultaneous events NOTE - All the initial ASF values are the same. It is impkmentation are all INDIVIDUAL. (NGMORE,MORE) undef NOMORE (OK,NOPICK) undef undef undef (OKJWCHOICE) (I..n) undef undef undef number WC (O..n) (O..n) nXP I I undef undef undef number WC (O..n) I P undef undef (NONE,LOCATOR,STROKE,VALU~TOR,CHOICE.PICK.STRING) S E undef NONE (OK,NOPICK) E N N undef undef undef (OK,NOCHOICE) (I..n) E I undef undef . R undef number WC (O..n) (O..n) nXP I I undef undef undef number (LOCATOR,STROKE.VALUATOR,CHOICE,PICK.STRING) . WC (O..n) E undef undef undef (In) (LAST,NOTLAST) N I E undef undef undef
event rcprl)

nXN

empty empty ewy

I
P

dependent whether the initial ASF values are all BUNDLED or
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6.5 Workstation state list One workstation state list exists for every open workstation. For workstations of category MO, the values marked w.d.t in the following list are actually implementation dependent because the workstation description table does not contain the corresponding entries.
Entries in this group exist for all workstation categories

workstation identifier connection identifier workstation type

N

ti
N the above 3 entries are initialised by OPEN WORKSTATION ,

Entries in

rltis group

do nnt exist for workstations

of cutegory INPUT

and MI

workstation state set of stored segmems for this workstation
Entries in this group do not exist,for workstations of catqories INPUT, WISS and MI

(INACTIVE,ACTIVE)

E nXN

INACTIVE

`deferral mode implicit regeneration mode display surface empty new frame aclion necessary al update number of polyline bundle table entries table of defined polyline bundles, for every entry: polyline index linelype linewidth scale factor polyline colour index number of polymarker bundle table entries table of defined polymarker bundles, for every entry: polymarker index marker lype marker size scale factor polymarker colour index number of text bundle table entries table of defined text bundles. for every entry: text index text font and precision character expansion factor character spacing text colour index number of fill area bundle table entries table of defined fill area bundles, for every enlry: iill area index fill area inlerior style till area style index till area colour index

(ASAP,BNIG,BNIL.ASTI) (SUPPRESSED.ALLOWED) (EMPTY,NOTEMPTY) (NO.YBS) (5.n) I

w.d.t w.d.t EMPTY NO w.d.1

(I..n) (-n..-l,l..n) 20 (O..n) (S..n)

I I R I I

w.d.t w.d.t w.d.t w.d.1 w.d.t

(I..n) (-n..-l,l..n) ;10 (O..n) (2..n)

I I R I I

w.d.t w.d.t w.d.1 w.d.1 w.d.1

(I..n) (-n..-I.I..n;STRING,CHAR,STROKE) >O (O..n) (5.n)

I (I:E) R R

I

w.d.1 w.d.t w.d.1 w.d.t w.d.1 w.d.1

\

(I .n) (HOLLOW.SOLID.PATTERN,HATCH) (-n..-l.l..n) (0.n)

w.d.1 w.d.t w.d.1 w.d.1
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number of pattern table enlries table of puttem representations, for every entry: pallem index pattern array dimensions pattern array (l..n) (In) (%.n) 2x1 nXnXl (0.x)

Workstatioa state list I
w.d.1

I

w.d.1 w.d.t w.ds w.d.t

number crf colour table enuies tabk of cokmr representations, for every en&y: coiour in&a colour (red, green, blue intensities)

(2..n)

1

1 3xR

w.d.t w.d.t

workstation transformation update state

(NOTl'ENDlNCi,PENDINC3)

E NOTPENDING

requested works&ion

window

NDC NDC DC DC

4XR 4XR 4xR 4xR

O,l,O,l O.l,O,l O,xd.O.yd O,xd,O,yd

current workstation window requested workstation viewport current workstation viewport

where (xd.yd) is the display space size from the w.d.t

Entries ti this group do not exist for worksrations for every logical input device of class LOCATOR: locator device number operating mode echo switch initial normalization transformation number inilial locator position prompl and echo type echo area locator data record for every logical input device of class STROKE: stroke device number operating mode echo switch inilial normalization transformation number initial number of points initial points in stroke prompt and echo type echo area stroke data record conlaining at least: input buffer size for every logical input device of class VALUATOR valuator device number operating mode echo switch initial value prompt and echo lype echo area valuator data record containing al least: low value high value

of caregories OUTPUT.

WISS, MO and MI

,
(I..n) (REQUEST,SAMPLE,EVENT) (ECHO.NOECHO) (O..n) WC (-n..-l.l..n) DC 4XR D I E E I P I w.d.t REQUEST ECHO 0 w.d.t I w.d.t i.d

(I..n) (REQUEST,SAMPLE,EVENT) (ECHO,NOECHO) (On) (O..n) WC (-n..-l,l..n) DC (l..n) 4XR nXP

1 E E I I

w.d.t REQUEST ECHO undef 0 empty

I
D

1
w.d.t i.d w.d.t

I

(I..n) (REQUEST,SAMPLE,EVENT) (ECHO.NOECHO) (-n..-1,l.n) DC 4xR

I E E R

w.d.t REQUEST ECHO w.d.t

I
D R R

I
w.d.t i.d w.d.t w.d.t
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for cvcry logical input dcvicc of class CHOICE: choice device number operoling mode echo switch inidul stalus initiul choice number prompt and echo type echo area choice data record DC (REQlJEST.SAMPLE.EVENT) (ECHO.NOECHO) (OK.NOCHOICE) (I..n) (-n..-l,l..n) 4XR D (l..n)

GKS data

strmcbres

I
E E

w.d.1 REQUEST ECHO

E NOCHOICE I 1 under I w.d.t i.d

for every logicttl input device of class PICK: pick device number operirling mode echo switch inidul slalus inilial Lgmenl initial pick identifier prompt und echo ~ypc echo area pick data record DC (-n..-l,l..n) 4xR D (REQlJEST.SAMPLE,EVENT) (ECIIO.NOECHO) (OK,NOPICK) (I..n) I E E E N N I w.d.c i.d w.d.1 REQUEST ECHO NOPICK under undef

for e&y

logwal input device of class STRING: (I..n) (REQUEST.SAMPLE.EVENT) (ECHO.NOECHO) j. (-n..-l.l..n) DC 4xR D (l..n) (IJI)

string device nlimbei operaling mode echo switch initial string prompt and echo type echo area string data record conluining al leasI: inpul huiTer size inilisl cursor posiJion

I
E E s I

w.d.t REQUEST ECHO ,. I w.d.t i.d w.d.t w.d.c

I
I
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6.6 Workstation description Workstation description table

table

There are three special categories of GKS workstation: a) WISS (Workstation c) MI (GKSM Input). For levels 0 and 1 there is no WISS; for level 2 there is exactly one WISS. There may be a number of different workstation types for MO and MI to accommodate mats. These special workstations have a restricted workstation description table. Further workstation types may be assigned and are implementation d) storage tube type 1; e) flat bed plotter 1. The workstation description tables cannot be changed by the application program. There is only one workstation description table-for each workstation type available in a given implementation.
Entries in this group exist for all workstation categories workstation type workstation category (OUTPLiT.INPUT,OUTIN.WISS.MO,M1) N E i.d i.d

Independent Segment Storage);

b) MO (GKSM Output);

different metafile for-

dependent, for example:

Entries in this group do not exist for workstations of categories WISS. MO and MI device coordinate units display space sixe (visible area of the display surface or available area on tablet for workstations of category INPUT) in device coordinate units in raster units DC >o 2XR 2xi i.d i.d (integer by integer) > 0 (for vector displays, for example, the raster units give the highest possibk reso&ion; for raster displays, the number of columns and lines of the raster array) Entries in this group do not exist for workstations of categories INPUT, WISS. MO and MI raster or vector display (VECTOR = vector display, RASTER = raster device, OTHER = other device, for example, vector + raster) dynamic modification accepted for: polyline bundle representation polymarker bundle representation text bundle representation fill area bundle representation pattern representation colour representation workstation transformation where: IRG: implicit regeneration necessary (may be deferred) IMM: performed immediately default value for: deferral mode implicit regeneration mode number of available linetypes `list of available linetypes number of available linewidths (a value of 0 indicates that a continuous range of linewidths is supported) nominal linewidth DC (ASAP.BNIG,BNIL,ASTl) (SUPPRESSED.ALLOWED) (4..n) (-n..-l,l..n) (0.n) >0 E E 9 I nXl i.d i.d i.d i.d i.d i.d (IRGJMM) (IRGJMM) (IRGJMM) (IRG,IMM) (IRGJMM) (IRGJMM) (IRG,`MM) i.d i.d i.d i.d i.d i.d i.d (VECTOR,RASTER.OTHER) E i.d (METRESOTHER) E i.d

I
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minimum linewidth maximum linewidth number of predefined polyline indices(bundles) table of predefined polyline bundles. for every entry: linetype linewidth scale factor polyline colour index (within range of predefined colour indices) number of available marker types list of available marker types number of available marker sizes (a value of 0 indicates that a continuous range of marker sixes is supported) nominal marker size minimum marker size maximum marker size number of predefined polymarker indices (bundles) table of predehned polymarker bundles. for every entry: marker type marker size scale factor polymarker colour index (within range of predefined colour indices) number of text font and precision pairs list of text font and precision pairs number of available character expansion factors minimum character expansion factor maximum character expansion factor (if the available character expansion factors vary between fonta. these vohres are for font l) number of available character heights (a value of 0 indicates that a continuous range of character heights is supported) minimum character height maximum character height number of predefined text indices(bundles) table of predefined text bundles, for every entry: text font and precision character expansion factor character spacing text colour index (within range of predefined colour indices) number of available fill area interior styles list of available fill area interior styles number of available hatch styles list of available halch styles number of predefined fill area indices(bund1e.s) table of predefined fill area bundles, for every entry: till area interior style fill area style index (HOLLOW,SOLID.PATTERN.HATCH) (-n..-l,l..n) E I i.d i.d (-n..-I.1 ..n;STRING.CHAR,STROKE) >o (0.n) (1..4) (HOLLOW.SOLID.PATTERN.HATCH) (0.3) (-n..-l,l..n) (5.n) nXE I nXl I (LE) R R i.d i.d i.d i.d i.d i.d i.d i.d i.d .." DC DC (O..n) (-n..-l,l..n) DC DC DC >O >o so (S..n) R R R I i.d i.d i.d i.d (O..n) (5.n) (-n..-l,l..n) DC DC >o `Q (5.n)

GKS data structures
R R I i.d i.d i.d

1
R I I nX1 I

i.d i.d i.d i.d i.d i.d

, (-n..-l,l..n)
(O..n)

I
R

i.d i.d i.d i.d id i.d i.d id i.d i.d i.d

1
(I..n)

i.d

I
n X (I;E) I R R

(-n..-l,l..n;STRING,CHAR,STROKE) (0.n) >o >o (O..n) >o >o (Z..n)

(a value of 0 indicates that a continuous range of character expansion factors is supported)

I
R R I

(if the available character heights vary between fonts, these values are for font 1)

I I

(for interior style PATTERN is within range of predefined pattern indices) (for interior style HATCH is within range of available hatch styles) till area colour index (within range of ,predefined colour indices) number of predel ,ned pattern indices (representations) table of predefincd paucra representalions.
for every enlry: po tlern array d iiilensions pallern irrrq

tO..n) (On)

9
2x1 nXnXl

I I

1.d i.d

(I..n) tO..nl

i.d i.d
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GKS data structures number of available colours or intensities (a value of 0 indicates that a continuous range of colour available number of predetined colour indices(representations1 table of predefined colour representations, for every entry: colour(red. green, blue intensities) number of available generalized drawing primilives list of available generalized drawing primitives (may be empty), for every GDP: GDP identifier number of sets of attributes used list of sets of attributes used maximum number of polyline bundle table entries maximum number of polymarker bundle table entries maximum number of text bundle table entries maximum number of fill area bundle table entries maximum number of pattern indices maximum number of colour indices number of segmenl priorities supported (a value of 0 indicates that a continuous range of priorities is supported) dynamic modification accepted for: segment transformation visibility (visible -+ invisible) visibility (invisible + visible) highlighting segment priority adding primitives to open segment overlapping segment of higher priority delete segment where: IRG: implicit regeneration necessary (may be deferred) IMM: performed immediately
Entries in this group do not exist for workstations of categories OUTPUT, WISS, MO and MI
colours is s&orted)

Workstation (0,2..n) (COLOUR,MONOCHROME) (2..n) at
kSt

description table' I E I
entries zero

i.d i.d i.d and one i.d i.d

P,Il
(On)

3xR I

N (POLYLINE.POLYMARKER,TEXT,FlLL (0..4) AREA) (5.n) (5.n) (2..n) (5.n) (0.n) (2..n) (O..n) I I I I I nXE

i.d id i.d i.d i.d i.d i.d i.d i.d

i
I

(IRGJMM) (IRGJMM) (IRG.IMM) (IRGJMM) (IRGJMM) (IRGJMM)

E E E E E E

i.d i.d i.d i.d i.d i.d

for every logical input device of class LOCATOR locator device number default initial locator position number of available prompt and echo types list of available prompt and echo types default echo area default locator data record for every logical input device of class STROKE: stroke device number maximum input buffer size number of available prompt and echo types list of available prompt and echo types , default echo area default stroke data record containing at least: input buffer size (I..n) (64.n) (I..n) (-n..-1,l.n) DC (I..n) nX1 4XR D I 1 I id i.d id i.d i.d i.d id DC
WC

(I ..n) (I..n) (-n..-l,l..n) 4xR

I

P I nX1 D

i.d i.d i.d i.d id id
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for every logical input device of class VALUATOR: valuator device number default initial value number of available prompt and echo types list of available prompt and echo types default echo area default valuator data record containing al least: low value high value for every logical input device of class CHOICE: choice device number maximum number of choice alternatives number of available prompt and echo types list of available prompt and echo types default echo area default choice data record for every logical input device of class PICK: pick device number number of available prompt and echo types list of available prompt and echo types default echo area default pick data record for every logical input device of class STRING: string device number maximum input buffer size number of available prompt and echo types list of available prompt and echo types default echo area default string data record containing al least: input buffer size initial cursor position (l..n) (I..n) DC (I..n) (72..n) (l..n) (-n..-l,l..n) nX1 4xR D I I 1 I I i.d i.d i.d i.d i.d i.d i.d
DC DC (I..n) (I..n) (I..n) (-n..-l.l..n) DC (I..n) I

GKS data structures

l

i.d i.d i.d i.d i,d i.d 1.d i.d

R (I ..n)
(-n..-l.l..n)

I nX1 4xR D R R

I I I flXI 4XR D

i.d i.d i.d i.d i.d i.d

(I..n) \ (I..n)
(-n..-l,l..n)

I I nXl 4xR D

i.d i.d i.d i.d i.d
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6.7 Segment state list One segment state list exists for the open segment and for each stored segment.
segment name set of associated workstations segment transformation matrix (the elements M 13 and M 23 are in NDC coordinates and the other elements are unitless) visibility highlighting segment priority detectability (VISIBLEJNVISIBLE) (NORMAL,HIGHLIGHTED) WI (UNDETECTABLE.DETECTABLE) E E R E UNDETECTABLE VISIBLE NORMAL 0
N

nXN active workstations at create segment Ix3xR

I ,o.o 0.1.0
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CKS data structures

6.8 GKS error state list cW'Or Slak
error tile identification workstation input class topical input device number of one of the logical input devices that caused an input queue overflow: identifier (LOCATOR.STROKE.VALUATOR,CHOICE.PICK.STRiNG~ (I..n) (OFF.ON) E N OFF i.d

N
E I

undef undef undef
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Annex A Function lists

(This annex forms an integral part of the standard.)

A. 1 Alphabetic
ACCUMULATE TRANSFORMATION MATRIX ACTIVATE WORKSTATION ASSOCIATE SEGMENT WITH WORKSTATION AWAIT EVENT CELL ARRAY CLEAR WORKSTATION CLOSE GKS CLOSE SEGMENT CLOSE WORKSTATION COPY SEGMENT TO WORKSTATION CREATE SEGMENT DEACTIVATE WORKSTATION DELETE SEGMENT DELETE SEGMENT FROM WORKSTATION EMERGENCY CLOSE GKS ERROR HANDLING ERROR LOGGING ESCAPE EVALUATE TRANSFORMATION MATRIX FILL AREA FLUSH DEVICE EVENTS GENERALIZED DRAWING PRIMITIVE (GDP) GET CHOICE GET ITEM TYPE FROM GKSM GET LOCATOR GET PICK GET STRING GET STROKE GET VALUATOR INITIALISE CHOICE INITIALISE LOCATOR INITIALISE PICK INITIALISE STRING INITIALISE STROKE INITIALISE VALUATOR INQUIRE CHOICE DEVICE STATE INQUIRE CLIPPING INQUIRE COLOUR FACILITIES INQUIRE COLOUR REPRESENTATION INQUIRE CURRENT INDIVIDUAL ATTRIBUTE VALUES INQUIRE CURRENT NORMALIZATION TRANSFORMATION INQUIRE CURRENT PICK IDENTIFIER VALUE INQUIRE CURRENT PRIMITIVE ATTRIBUTE VALUES INQUIRE DEFAULT CHOICE DEVICE DATA INQUIRE DEFAULT DEFERRAL STATE VALUES INQUIRE DEFAULT LOCATOR DEVICE DATA INQUIRE DEFAULT PICK DEVICE DATA Page 173 69 101 122 77 69 67 99 68 101 99 69 100 loo 174 174 174 73 173 75 123 78 124 126 123 124 125 123 124 109 106 110 111 107 108 150 134 160 146 132 132 131 131 167 154 165 168 191

NUMBER
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Annex A DEFAULT STRING DEVICE DATA DEFAULT STROKE DEVICE DATA DEFAULT VALUATOR DEVICE DATA DISPLAY SPACE SIZE DYNAMIC MODIFICATION OF SEGMENT ATTRIBUTES DYNAMIC MODIFICATION OF WORKSTATION ATTRIBUTES FILL AREA FACILITIES FILL AREA REPRESENTATION GENERALIZED DRAWING PRIMITIVE INPUT QUEUE OVERFLOW LEVEL OF GKS LIST OF AVAILABLE GENERALIZED DRAWING PRIMITIVES LIST OF AVAILABLE WORKSTATION TYPES LIST OF COLOUR INDICES LIST OF FILL AREA INDICES LIST OF NORMALIZATION TRANSFORMATION NUMBERS LIST OF PATTERN INDICES LIST OF POLYLINE INDICES LIST OF POLYMARKER INDICES LIST OF TEXT INDICES LOCATOR DEVICE STATE MAXIMUM LENGTH OF WORKSTATION STATE TABLES MAXIMUM NORMALIZATION TRANSFORMATION NUMBER MORE SIMULTANEOUS EVENTS NAME OF OPEN SEGMENT NORMALIZATION TRANSFORMATION NUMBER OF AVAILABLE LOGICAL INPUT DEVICES NUMBER OF SEGMENT PRIORITIES SUPPORTED OPERATING STATE VALUE PATTERN FACILITIES PATTERN REPRESENTATION PICK DEVICE STATE PIXEL PIXEL ARRAY PIXEL ARRAY DIMENSIONS POLYLINE FACILITIES POLYLINE REPRESENTATION POLYMARKER FACILITIES POLYMARKER REPRESENTATION PREDEFINED COLOUR REPRESENTATION PREDEFINED FILL AREA REPRESENTATION PREDEFINED PATTERN REPRESENTATION PREDEFINED POLYLINE REPRESENTATION PREDEFINED POLYMARKER REPRESENTATION PREDEFINED TEXT REPRESENTATION SEGMENT ATTRIBUTES SET OF ACTIVE WORKSTATIONS SET OF ASSOCIATED WORKSTATIONS SET OF OPEN WORKSTATIONS SET OF SEGMENT NAMES IN USE SET OF SEGMENT NAMES ON WORKSTATION STRING DEVICE STATE STROKE DEVICE STATE TEXT EXTENT TEXT FACILITIES TEXT REPRESENTATION VALUATOR DEVICE STATE 168 166 166 153 164 153 158 143 162 172 128 161 129 145 143 133 144 137 138 139 148 162 130 135 134 133 164 163 128 159 145 151 171 170 170 154 137 156 139 161 159 160 155 156 158 169 130 169 130 134 147 151 149 141 157 140 149

INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE 192
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INQUIRE WORKSTATION CATEGORY INQUlRE WORKSTATION CLASSIFICATION INQLJIRE WORKSTATION CONNECTION AND TYPE I'NQUIRE WORKSTATION DEFERRAL AND UPDATE STATES INQUIRE WORKSTATION MAXIMUM NUMBERS INQUIRE WORKSTATION STATE INQUIRE WORKSTATION TRANSFORMATION INSERT SEGMENT INTERPRET ITEM MESSAGE OPEN GKS OPEN WORKSTATION POLYLINE POLYMARKER READ ITEM FROM GKSM REDRAW ALL SEGMENTS ON WORKSTATION RENAME SEGMENT REQUEST CHOICE REQUEST LOCATOR REQUEST PICK REQUEST `STRING REQUEST STROKE REQUEST VALUATOR SAMPLE CHOICE SAMPLE LOCATOR SAMPLE PICK SAMPLE STRING SAMPLE STROKE SAMPLE VALUATOR SELECT NORMALIZATION TRANSFORMATION SET ASPECT SOURCE FLAGS SET CHARACTER EXPANSION FACTOR SET CHARACTER HEIGHT SET CHARACTER SPACING SET CHARACTER UP VECTOR SET CHOICE MODE SET CLIPPING INDICATOR SET COLOUR REPRESENTATION SET DEFERRAL STATE SET DETECTABILITY SET FILL AREA COLOUR INDEX SET FILL AREA INDEX SET FILL AREA INTERIOR STYLE SET FILL AREA REPRESENTATION SET FILL AREA STYLE INDEX SET HIGHLIGHTING . SET LINETYPE SET LINEWIDTH SCALE FACTOR * SET LQCATOR MODE SET MARKER SIZE SCALE FACTOR SET MARKER TYPE SET PATTERN REFERENCE POINT SET PATTERN REPRESENTATION SET PATTERN SIZE SET PICK IDENTIFIER SET PICK MODE SET POLYLINE COLOUR INDEX

152 152 135 136 129 136 147 102 127 72 67 67 74 74 126 70 99 117 116 118 118 116 117 121 119 121 122 120 120 97 89 84 85 84 85 114 97 94 72 105 88 86 87 93 87 104 80 81 113 82 82 88 94 88 89 115 81
193
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A
80

SET POLYLINE INDEX SET POLYLINE REPRESENTATION SET POLYMARKER COLOUR INDEX SET POLYMARKER INDEX SET POLYMARKER REPRESENTATION SET SEGMENT PRIORITY SET SEGMENT TRANSFORMATION SET STRING MODE SET STROKE MODE SET TEXT ALIGNMENT SET TEXT COLOUR INDEX SET TEXT FONT AND PRECISION SET TEXT INDEX SET TEXT PATH SET TEXT REPRESENTATION SET VALUATOR MODE SET VIEWPORT SET VIEWPORT INPUT PRIORITY SET VISIBILITY , SET WINDOW SET WORKSTATION VIEWPORT SET WORKSTATION WINDOW TEXT UPDATE WORKSTATION WRITE ITEM TO GKSM

90
83 81 91 104 103 115 113 86 85 83 83 86 92 114 96 96 103 96 98 97 75 71 126

A.2 Order of appearance
Control functions (5.2) 67 67 67 67 68 69 69 69 70 71 72 72 73 74 74 74 75 75 77 78

OPEN GKS CLOSE GKS OPEN WORKSTATION CLOSE WORKSTATION ACTIVATE WORKSTATION DEACTIVATE WORKSTATION CLEAR WORKSTATION REDRAW ALL SEGMENTS ON WORKSTATION UPDATE WORKSTATION SET DEFERRAL STATE MESSAGE ESCAPE Output functions POLYLINE POLYMARK.ER TEXT FILL AREA CELL ARRAY GENERALIZED (5.3)

DRAWING

PRIMITIVE

(GDP)
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Order of appearance

Output attributes Workstation SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET

(5.4) (5.4. I )

80

independent primitive attributes

80 80 8G 81 81 81 82 82 83 83 83 84 84 . 85 85 85 86 86 86 87 87 88 88 88 89 89
90 90 91 92 93 94 94 96

POLYLINE INDEX LINETYPE LINEWIDTH SCALE FACTOR POLYLINE COLOUR INDEX POLYMARKER INDEX MARKER TYPE MARKER SIZE SCALE FACTOR POLYMARKER COLOUR INDEX TEXT INDEX TEXT FONT AND PRECISION CHARACTER EXPANSION FACTOR CHARACTER SPACING TEXT COLOUR INDEX CHARACTER HEIGHT CHARACTER UP VECTOR TEXT PATH TEXT ALIGNMENT FILL AREA INDEX FILL ,AREA INTERIOR STYLE FILL AREA STYLE INDEX FILL AREA COLOUR INDEX PATTERN SIZE PATTERN REFERENCE POINT ASPECT SOURCE FLAGS ' PICK IDENTIFIER attributes (representations) (5.4.2)

Workstation SET SET SET SET SET SET

POLYLINE REPRESENTATION POLYMARKER REPRESENTATION TEXT REPRESENTATION FILL AREA REPRESENTATION PATTERN REPRESENTATION COLOUR REPRESENTATION functions (5.5) (5.5.1)

Transformation Normalization

transformation

96 96 96 96 97 97
97 97 98

SET WINDOW I SET VIEWPORT SET VIEWPORT INPUT PRIORITY SELECT NORMALIZATION TRANSFORMATION SET CLIPPING INDICATOR Workstation transformation (5.5.2)

SET WORKSTATION SET WORKSTATION

WINDOW VIEWPORT
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Segment fun&ions

(3.6) functions (5.6.1)

99
99 99 99 99 100 100

Segment manipulation

CREATE SEGMENT CLOSE SEGMENT RENAME SEGMENT DELETE SEGMENT DELETE SEGMENT FRdM WORKSTATION ASSOCIATE SEGMENT WITH WORKSTATION COPY SEGMENT TO WORKSTATiON INSERT SEGMENT Segment attributes SET SET SET SET SET (56.2)

101 101 102 103 103 103 104 104 105 106 106 106 107 108 109 110 111 113 113 113 114 114 115 115 116 116 116 117 117 118 118

SEGMENT TRANSFORMATIOi\l VISIBILITY HIGHLIGHTING SEGMENT PRIORITY DETECTABILITY (5.7)

Input functions

Initialisation of input devices (5.7.1) INITIALISE LOCATOR INITIALISE.STROKE INITIALISE VALUATOR INITIALISE CHOICE INITIALISE PICK INITIALISE STRING Setting the mode of input devices (5.7.2) SET SET SET SET SET SET LOCATOR MODE STROKE MODE VALUATOR MODE CHOICE MODE PICK MODE STRING MODE (5.7.3)

Request input functions REQUEST REQUEST REQUEST REQUEST REQUEST REQUEST LOCATOR STROKE VALUATOR CHOICE PICK STRING

Sample input functions SAMPLE SAMPLE SAMPLE SAMPLE SA:: PLE SAMPLE LOCATOF STROKE VALUATOR CHOICE PICK STRING

(5.7.4)

119 119 120 120 121 121 122

**
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IS0 7942 - 1985 Annex A Event input functions (5.7.5) Order of appearance 122 122 123 123 I23 124 124 124 125 126 126 126 126 127 128 (5.9.1) 128 128 128 128 128 129 129 130 130 130 130 131 131 132 132 133 133 134 134 134 135 135 135 136 136 137 137 138 139 139 140 141 143

AWAIT' EVENT FLUSH DEVICE EVENTS GET LOCATOR GET STROKE GET VALUATOR GET CHOICE GET PICK GET STRING Metafile functions (5.8)

WRITE ITEM TO GKSM GET ITEM TYPE FROM,GKSM READ ITEM FROM GKSM INTEFPRET ITEM Inquiry functions Introduction (5.9)

to inquiry functions

Inquiiy function for operating state value (5.9.2) INQUIRE OPERATING STATE VALUE

Inquiry functions for GKS description table (5.9.3) INQUIRE INQUIRE INQUIRE INQUIRE LEVEL OF GKS LIST OF AVAILABLE WORKSTATION TYPES WORKSTATION MAXIMUM NUMBERS MAXIMUM NORMALIZATION TRANSFORMATION

NUMBER

Inquiry functions for GKS state list (5.9.4) INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE SET OF OPEN WORKSTATIONS SET OF ACTIVE WORKSTATIONS CURRENT PRIMITIVE ATTRIBUTE VALUES CURRENT PICK IDENTIFIER VALUE CURRENT INDIVIDUAL ATTRIBUTE VALUES CURRENT NORMALIZATION TRANSFORMATION NUMBER LIST OF NORMALIZATION TRANSFORMATION NUMBERS NORMALIZATION TRANSFORMATION CLIPPING NAME OF OPEN SEGMENT SET OF SEGMENT NAMES IN USE MORE SIMULTANEOUS EVENTS

/

Inquiry functions for workstation state list (5.9.5) INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQIJIRE INQtifRE INQUIRE INQUIRE WORKSTATION CONNECTION AND TYPE WORKSTATION STATE WORKSTATION DEFERRAL AND UPDATE STATES LIST OF POLYLINE INDICES POLYLINE REPRESENTATION LIST OF POLYMARKER INDICES POLYMARKER REPRESENTATION LIST OF TEXT INDICES TEXT REPRESENTATION TEXT EXTENT LIST OF FILL AREA INDICES

9
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IS: Order of appearance INQUIRE INQUIRE INQUIRE INQUIRE 1NQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE FILL AREA REPRESENTATION LIST OF PATTERN INDICES PATTERN REPRESENTATION LIST OF COLOUR INDICES COLOUR REPRESENTATION WORKSTATION TRANSFORMATION SET OF SEGMENT NAMES ON WORKSTATION LOCATOR DEVICE STATE STROKE DEVICE STATE VALUATOR DEVICE STATE CHOICE DEVICE STATE PICK DEVICE STATE STRING DEVICE STATE
Annex A

143 144 145 145 146 147 147 148 149 149 150 151 151 152 152 152 153 153 154 154 155 156 156 157 158 158 159 159 160. 160 161 161 162 162 163 164 164 165 166 166 167 168 168 169 169 169 170 170 I 70 171

Inquiry functions for workstation description table (5.9.6) INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQIJIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE INQUIRE WORKSTATION CATEGORY WORKSTATION CLASSIFICATION DISPLAY SPACE SIZE DYNAMIC MODIFICATION OF WORKSTATIOET ATTRIBUTES DEFAULT DEFERRAL STATE VALUES POLYLINE FAFILITIES PREDEFINED POLYLINE REPRESENTATION POLYMARKER FACILITIES PREDEFINED POLYMARKER REPRESENTATION TEXT FACILITIES PREDEFINED TEXT REPRESENTATION FILL AREA FACILITIES PREDEFINED FILL AREA REPRESENTATION PATTERN FACILITIES PREDEFINED PATTERN REPRESENTATION COLOUR FACILITIES PREDEFINED COLOUR REPRESENTATION LIST OF AVAILABLE GENERALIZED DRAWING PRIMITIVES GENERALIZED DRAWING PRIMITIVE MAXIMUM LENGTH OF WORKSTATION STATE TABLES NUMBER OF SEGMENT PRIORITIES SUPPORTED DYNAMIC MODIFICATION OF SEGMENT ATTRIBUTES NUMBER OF AVAILABLE LOGICAL INPUT DEVICES DEFAULT LOCATOR DEVICE DATA DEFAULT STROKE DEVICE DATA DEFAULT VALUATOR DEVICE DATA DEFAULT CHOICE DEVICE DATA DEFAULT PICK DEVICE DATA DEFAULT STRING DEVICE DATA

Inquiry functions for segment state list (5.9.7) INQUIRE SET OF ASSOCIATED WORKSTATIONS INQUIRE SEGMENT ATTRIBUTES Pixel inquiries (5.9.8) INQUIRE PIXEL ARRAY DIMENSIONS INQLJIRE PIXEL ARRAY INQUIRE PIXEL
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Inquiry function for GKS error state list (59.9) INQUIRE INPUT QUEUE OVERFLOW (5.10)

172 172 173 173 173 174 174 174 174

Utility functions

EVALUATE TRANSFORMATION MATRIX ACCUMULATE TRANSFORMATION MATRIX Error handling (5.11)

EM.ERGENCY CLOSE GKS ERROR HANDLING ERROR LOGGING

A.3 Ordered by level
A.3.1 Level Oa ACTIVATE WORKSTATION CELL ARRAY CLEAR WORKSTATION CLOSE GKS CLOSE WORKSTATION DEACTIVATE WORKSTATION EMERGENCY CLOSE GKS ERROR HANDLING ERROR LOGGING ESCAPE FILL AREA GENERALIZED DRAWING PRIMITIVE (GDP) GET ITEM TYPE FROM GKSM INQUIRE CLIPPING INQUIRE COLOUR FACILITIES INQUIRE COLOUR REPRESENTATION INQUIRE CURRENT INDIVIDUAL ATTRIBUTE VALUES INQUIRE CURRENT NORMALIZATION TRANSFORMATION NUMBER INQUIRE CURRENT PRIMITIVE ATTRIBUTE VALUES INQUIRE DISPLAY SPACE SIZE INQUIRE FILL AREA FACILITIES INQUIRE GENERALIZED DRAWING PRIMITIVE INQUIRE LEVEL OF GKS INQUIRE LIST OF AVAILABLE GENERALIZED DRAWING PRIMITIVES INQUIRE LIST OF AVAILABLE WORKSTATION TYPES INQUIRE LIST OF COLOUR INDICES INQUIRE LIST OF NORMALIZATION TRANSFORMATION NUMBERS INQUIRE MAXIMUM LENGTH 0~ WORKSTATION STATE TABLES INQUIRE MAXIMUM NORMALIZATION TRANSFORMATION NUMBER INQUIRE NORMALIZATION TRANSFORMATION INQUIRE OPERATING STATE VALUE INQUIRE PATTERN FACILITIES INQUIRE PIXEL INQUIRE PIXEL ARRAY INQUIRE PIXEL ARRAY DIMENSIONS INQUIRE POLYLINE FACILITIES INQUIRE POLYMARKER FACILITIES INQUIRE PREDEFENED COLOUR REPRESENTATION INQUIRE PREDEFINED FILL AREA REPRESENTATION INQUIRE PREDEFINED PATTERN REPRESENTATION INQUIRE PREDEFINED POLYLINE REPRESENTATION 69 77 69 67 68 69 174 174 174 73 75 78 126 134 160 146 132 132 131 153 158 162 128 161, 129 145 133 162 130 133 128 159 171 170 170 154 156 161 159 160 155
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Ordctid by level INQUIRE INQUIRE INQUIRE PREDEFINED POLYMARKER REPRESENTATION PREDEFINED TEXT REPRESENTATION SET OF OPEN WORKSTATIONS

Annex

A 156 IS8 130 141 IS7 I52 152 135 136 136 147 127 67 67 74 74 126 97 89 84 85 84 85 97 94 88 86 87 87 80 81 82 82 88 88 81 80 83 81 86 85 83 83 86 96 96 98 97 75 71 126

INQUIRE TEXT EXTENT INQUIRE TEXT FACILITIES INQUIRE WORKSTATION CATEGORY INQUIRE WORKSTATION CLASSIFICATION INQUIRE WORKSTATION CONNECTION AND TYPE INQUIRE WORKSTATION DEFERRAL AND UPDATE STATES INQUIRE WORKSTATION STATE INQUIRE WORKSTATION TRANSFORMATION INTERPRET ITEM OPEN GKS OPEN WORKSTATION POLY LINE POLYMARKER READ ITEM FROM GKSM SELECT NORMALIZATION TRANSFORMATION SET ASPECT SOURCE FLAGS SET CHARACTER EXPANSION FACTOR SET CHARACTER HEIGHT SFiT CHARACTER SPACING SET CHARACTER UP VECTOR SET CLIPPING INDICATOR SET COLOUR REPRESENTATION SET FILL AREA COLOUR INDEX SET FILL AREA INDEX SET FILL AREA INTERIOR STYLE SET FILL AREA STYLE INDEX SET LINETYPE SET LINEWIDTH SCALE FACTOR SET MARKER SIZE SCALE FACTOR SET MARKER TYPE SET PATTERN REFERENCE POINT SET PATTERN SIZE SET POLYLINE COLOUR INDEX SET POLYLINE INDEX SET POLYMARKER COLOUR INDEX SET POLYMARKER INDEX SET TEXT ALIGNMENT SET TEXT COLOUR INDEX SET TEXT FONT AND PRECISION SET TEXT INDF SET TEXT PATH SET VIEWPORT SET WINDOW SET WORKSTATION VIEWPORT SET WORKSTATION WINDOW TEXT UPDATE WORKSTATION WRITE ITEM TO GKSM A.3.2 Level Ob INITIALISE INITIALISE iNITIALISE INITIALISE 206 CHOICE LOCATOR STRING STROKE
*
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Ordered by level 108 150 167 165 168 166 166 148 164 151 149 149 117 115 118 116 117 114 113 115 113 114 96

INITIALISE VALUATOR INQUIRE CHOICE DEVICE STATE INQUIRE DEFAULT CHOICE DEVICE DATA INQUIRE DEFAULT LOCATOR DEVICE DATA INQUIRE DEFAULT STRING DEVICE DATA INQUIRE DEFAULT STROKE DEVICE DATA INQUIRE DEFAULT VALUATOR DEVICE DATA INQUIRE LOCATOR DEVICE STATE INQUIRE NUMBER OF AVAILABLE LOGICAL INPUT DEVICES INQUIRE STRING DEVICE STATE INQUIRE STROKE DEVICE STATE INQUIRE VALUATOR DEVICE STATE REQUEST CHOICE REQUEST LOCATOR REQUEST STRING REQUEST STROKE REQUEST VALUATOR SET CHOICE MODE SET LOCATOR MODE SET STRING MODE SET STROKE MODE SET VALUATOR MODE SET VIEWPORT INPUT PRIORITY A.3.3 Level Oc AWAIT EVENT FLUSH DEVICE EVENTS GET CHOICE GET LOCATOR GET STRING GET STROKE GET VALUATOR INQUIRE INPUT QUEUE OVERFLOW INQUIRE MORE SIMULTANEOUS EVENTS SAMPLE CHOICE SAMPLE LOCATOR SAMPLE STRING SAMPLE STROKE SAMPLE VALUATOR A.3.4 Level la ACCUMULATE TRANSFORMATION MATRIX CLOSE SEGMENT CREATE SEGMENT DELETE SEGMENT DELETE SEGMENT FROM WORKSTATION EVALUATE TRANSFORMATION MATRIX INQUIRE DEFAULT DEFERRAL STATE VALUES INQUIRE DYNAMIC MODIFICATION OF SEGMENT ATTRIBUTES INQUIRE DYNAMIC MODIFICATION OF WORKSTATION ATTRIBUTES INQUIRE FILL AREA REPRESENTATION INQUIRE LIST OF FILL AREA INDICES INQUIRE LIST OF PATTERN INDICES INQUIRE LIST OF POLYLINE INDICES INQUIRE LIST OF POLYMARKER INDICES INQUIRE LIST OF TEXT INDICES I.

122 123 124 123 125 123 124 172, 135 121 119 122 120 120

9

173 99 99 100 100 173 154 164 153 143 143 144 131 138 139
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INQUIRE NAME OF OPEN SEGMENT INQUIRE NUMBER OF SEGMENT PRIORITIES SUPPORTED INQUIRE PATTERN REPRESENTATION INQUIRE POLYLINE REPRESENTATION INQUIRE POLYMARKER REPRESENTATION INQUIRE SEGMENT ATTRIBUTES INQUIRE SET OF ACTIVE WORKSTATIONS INQUIRE SET OF ASSOCIATED WORKSTATIONS INQUIRE SET OF SEGMENT NAMES IN USE INQUIRE SET OF SEGMENT NAMES ON WORKSTATION INQUIRE TEXT REPRESENTATION INQUIRE WORKSTATION MAXIMUM NUMBERS MESSAGE REDRAW ALL SEGMENTS ON WORKSTATION RENAME SEGMENT SET DEFERRAL STATE SET FILL AREA REPRESENTATION SET HIGHLIGHTING SET PATTERN REPRESENTATION SET POLYLINE REPRESENTATION SET POLYMARKER REPRESENTATION SET SEGMENT PRIORITY SET SEGMENT TRANSFORMATION SET TEXT REPRESENTATION SET VISIBILITY
l

134 163 145 137 139 169 130 169 134 147 140 129 72 70 99 72 93 104 94 90 91 104 103 92 103

A.3.5 Level lb INITIALISE PICK INQUIRE CURRENT PICK IDENTIFIER VALUE INQUIRE DEFAULT PICK DEVICE DATA INQUIRE PICK DEVICE STATE REQUEST PICK SET DETECTABILITY SET PICK IDENTIFIER SET PICK MODE A.3.6 Level lc GET PICK SAMPLE PICK A.3.7 Level 2a ASSOCIATE SEGMENT WITH WORKSTATION COPY SEGMENT TO WORKSTATION INSERT SEGMENT A.4 Ordered by state A.4.1 Functions allowed in state GKCL EMERGENCY CLOSE GKS ERROR HANDLING ERROR LOGGING Inquiry fimctions OPEN GKS 174 174 174
l

110 131 168 151 118 105 89 115

124 121

101 101 102

67

202
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Ordered by state

ACCUMULATE TRANSFORMATION MATRIX CLOSE GKS EMERGENCY CLOSE GKS ERROR HANDLING ERROR LOGGING ESCAPE EVALUATE TRANSFORMATION MATRIX Inquiry functions INTERPRET ITEM OPEN WORKSTATION SELECT NORMALIZATION TRANSFORMATION SET ASPECT SOURCE FLAGS SET CHARACTER EXPANSION FACTOR SET CHARACTER HEIGHT SET CHARACTER SPACING SET CHARACTER UP VECTOR SET CLIPPING INDICATOR SET FILL AREA COLOUR INDEX SET FILL AREA INDEX SET FILL AREA INTERIOR STYLE SET FILL AREA STYLE INDEX SET LINFTYPE SET LINEWIDTH SCALE FACTOR SET MARKER SIZ& SCALE FACTOR SET MARKER TYPE SET PATTERN REFERENCE POINT SET PATTERN SIZE SET PICK IDENTIFIER SET POLYLINE COLOUR INDEX SET POLYLINE INDEX SET POLYMARKER COLOUR INDEX SET POLYMARKER INDEX SET TEXT ALIGNMENT SET TEXT COLOUR INDEX SET TEXT FONT AND PRECISION . SET TEXT INDEX SET TEXT PATH SET VIEWPORT SET VIEWPORT INPUT PRIORITY SET WINDOW
A.4.3

173 67 174 174 174 73 173 127 67 97 87 84 85 84 85 97 88 86 87 87 80 81 82 82 88 88 89 81 80 83 81 86 85 83 83 86 96 96 96

Functions not allowedin state WSOP 77 67 99 69 75 78 102 67 74 74 75 126

CELL ARRAY CLOSE GKS CREATE SEGMENT DEACTIVATE WORKSTATION FILL AREA GENERALIZED DRAWING PRIMITIVE INSERT SEGMENT OPEN GKS POLYLINE POLYMARKER TEXT WRITE ITEM TO GKSM

(GDP)

*

203

IS : 12389 - 1987 IS0 7942 - 1986
Ordered by
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A.4.4 Functions not allowed in state WSAC CLOSE GKS CLOSE SEGMENT OPEN GK.S A.4.5 Functioos not allowed in state SGOP ACTIVATE WORKSTATION ASSOCIATE SEGMENT WITH WORKSTATION CLEAR WORKSTATION CLOSE GKS COPY SEGMENT TO WORKSTATION CREATE SEGMENT DEACTIVATE WORKSTATION OPEN GKS
69

67 99 67

101 69 67 101 99 69 67

A.5 Applicability to workstation group
Table 3 lists all GKS functions and the workstation categories to which they apply, directly or indirectly. T&e 3 - GKS tunetIoas ld workstatloa categories to whieb they aPply
-GKS Fmactkm

COBWOIfWCtkBl OPEN GKS CLOSE GKS OPEN WORKSTATION CLOSE WORKSTATION ACTIVATE WORKSTATION DEACTIVATE WORKSTATION CLEAR WORKSTATION REDRAW ALL SEGMENTS ON WORKSTATION UPDATE WORKSTATION SET DEFERRAL STATE MESSAGE ESCAPE wfPOLYLINE POLYMARKER TEXT FILL AREA CELL ARRAY GENERALIZED

SS SS SS SS SS

SS

not applicable not applkabk 01 I MO 0 01 I MO 0 01 MO 0 01 MO 0 01 MO 0 01 MO 0 01 MO 0 01 MO 0 01 I MO 0 01 1 MO 0

MI MI

MI

DRAWING

PRIMITIVE (GDP)

SS SS SS SS SS SS

MO MO MO MO MO MO

0 0 0 0 0 0

01 01 01 01 01 01

Output aSET POLYLINE INDEX SET LINETYPE SET LINEWIDTH SCALE FACTOR SET POLYLINE COLOUR INDEX SET POLYMARKER INDEX SET MARKER TYPE SET MARKER SIZE SCALE FACTOR SET POLYMARKER COLOUR INDEX SET TEXT INDEX SET TEXT FONT AND PRECISION SET CHARACTER EXPANSION FACTOR ! SET CHARACTER SPACING SET TEXT COLOUR INDEX ; SET CHARACTER HEIGHT : SET CHARACTER UP VECTOR SET TEXT PATH SET TEXT ALIGNMENT

SS SS SS SS SS SS SS SS SS SS i SS
!

MO MO MO MO MO MO MO MO MO MO MO

0 0 0 0 0 0 0 0 0 0 0

SS
SS SS ss SS SS

MO
MO MO MO MO MO

0
0 0 0 0 0

01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 01
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/ SET SET SET SET SET SET SET SET SET SET SET SET SET SET FILL AREA INDEX FILL AREA INTERIOR STYLE FILL AREA STYLE INDEX FILL AREA COLOUR INDEX PATTERN SIZE PATTERN REFERENCE PGINT ASPECT SOURCE FLAGS PICK IDENTIFIER POLYLINE REPRESENTATION POLYMARKER REPRESENTATION TEXT REPRESENTATION FILL AREA REPRESENTATION PATTERN REPRESENTATION COLOUR REPRESENTATION

ss ss ss ss ss ss ss ss

MO MO MO MO MO MO MO MO MO MO MO MO MO MO

0 0
0 0 0 0

01 01
01 01 01

1

0 0 0
0

01 01
01 01

01
01 01

0
0 0 0

01 01

Trrmlormatba lunctbo~ SET WINDOW SET VIEWPORT SET VIEWPORT INPUT PRIORITY SELECT NORMALIZATION TRANSFORMATION SET CLIPPING INDICATOR SET WORKSTATION WINDOW SET WORKSTATION VIEWPORT

ss ss ss
SS SS

MO
MO MO

0
0 0 0 0

01 01

MO MO MO MO

01
01

I I I I I I

01
01 01

0 0

seullclltf-ti-

CREATE SEGMENT CLOSE SEGMENT RENAME SEGMENT DELETE SEGMENT DELETE SEGMENT FROM WORKSTATION ASSOCIATE SEGMENT WITH WORKSTATION COPY SEGMENT TO WORKSTATION INSERT SEGMENT SET SEGMENT TRANSFORMATION SET VISIBILITY SET HIGHLIGHTING SET SEGMENT PRIORITY SET DETECTABILITY hIput 1ltBctlor INITIALISE LOCATOR INITIALISE STROKE INITIALISE VALUATOR INITIALISE CHOICE INITIALISE PICK INITIALISE STRING SET LOCATOR MODE SET STROKE MODE SET VALUATOR MODE SET CHOICE MODE SET PICK MODE SET STRING MODE REQUEST LOCATOR REQUEST STROKE REQUEST VALUATOR REQUEST CHOICE REQUEST PICK REQUEST STRING SAMPLE LOCATOR SAMPLE STROKE SAMPLE VALUATOR SAMPLE CHOICE SAMPLE PICK SAMPLE STRING AWAIT EVENT

ss ss ss ss ss ss
(ss)

MO
MO MO MO

0 0 0 0

01 01 01

ss ss ss ss
ss SS

MO MO MO MO MO
MO MO MO

MO

0 0 0 0 0 0 0
0 0

01 01 01 01 01
01

01
01 01 01

01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 01

1 I I I I I I I I I I I I I I I I I

01 01 01 01
01

I I
1
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1FLUStt DEVICE EVENTS / GET LOCATOR 1 GET STROKE ! GET VALUATOR GET CHOtCE GET PICK GET STRING
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Annex B
Error list
(This annex forms an integral part of the standard.)

B. 1 Implementation dependent c 0 Implementation dependent errors
B.2 States

I GKS not in proper state: GKS shall be in the state GKCL
2 3 4 5 6 7 8 GKS GKS GKS GKS GKS GKS GKS not not not not not not in proper in proper in proper in proper in proper in proper not in proper state: state: state: state: state: state: state: GKS GKS GKS GKS GKS GKS GKS shall shall shall shall shall shall shall be be be be be be be in the state GKOP in the state WSAC in the state SGOP either in the state WSAC or in the state SGOP either in the state WSOP or in the state WSAC in one of the states WSOP, WSAC or SGOP in one of the states GKOP. WSOP, WSAC or SGOP

B.3 Workstations
20 2I 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 Specified workstation identtjier is invalid Specified connection identt$er is invalid Specified workstation type is invalid Specified workstation type does not exist Specified workstation is open Specified workstation is not open Spectfied workstation cannot be opened Workstation Independent Segment Storage is not open Workstation Independent Segment Storage is already open Specified workstation is active Specified workstation is not active Specified workstation is of category MO Specified workstation is not of category MO Specified workstation is of category MI Specified workstation is not of category MI Specified workstation is of category INPUT Specified workstation is Workstation Independent Segment Storage Specified workstation is not of category OUTIN Specified workstation is neither of category INPUT nor of category OUTIN Specified workstation is neither of category OUTPUT nor of category OUTIN Specified workstation has no pixel store readback capability Spectjied workstation type is not able to generate the specified generalized drawing primitive Maximum number of simultaneouslv open workstations would be exceeded Maximum number of simultaneously active workstations would be exceeded

B.4 Transformations
SO Transformation number is invalid .5/ Rectangle definition is invalid 52 Viewport is not within the Normalized Device Coordinate unit square 53 Workstation window is not within the Normalized Device Coordinate unit square 54 Workstation viewport is not within the displuy space

I
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B.5 Output attributes
60 61

62
63 64 6.5 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97

Po(vline index is invalid A representation for the spect@ed polylhte index has not been deBned on thp workstation A representation for the spectjied polyline index has not been pred&ed on this workstation Linetype is equal to zero Specified linetype is not supported on this workstation Linewidth scale factor is less than zero Polymarker index is invalid A representation for the specified polymarker index has not been defined on this workstation A representation for the specified polymarker index has not been predejined on this workstation Marker type is equal to zero Specified marker type is not supported on this workstation Marker size scale factor is less than zero Text index is invalid A representation,for the specified text index has not been defined on this workstation A representation for the spectjied text index has not been predefined on this workstation Text font is equal to zero Requested text font is not supported for the specified precfsion on this workstation Character expansion factor is less than or equal to zero Character height is less than or equal to zero Length of character up vector is zero Fill area index is invalid A representation for the spectjiedjill area index has not been defined on this workstation A representation for the spect$edjll area index has not been predefined on this workstation Spectjiedfirr area interior style is not supported on this workstation Style (pattern or hatch) index is equal to zero Specified pattern index is invalid Specijed hatch style is not supported on this workstation Pattern size value is not positive A representation for the spect@ed pattern index has not been defined on this workstation A representation for the specifeti pattern index has not been pre&fined on this workstation Interior style PATTERN is not supported on this workstation Dimensions of colour array are invalid Colour index is less than zero Colour index is invalid A representation for the spect@ed cplour index has not been defined on this workstation A representation for the specified colour index has not been predefined on this workstation Colour is outside range /OS J Pick identtfer is invalid

B.6 output primitives
100 101 102 103 104 105 Number of points is invalid Invalid code in string Generalized drawing primitive identifier is invalid Content of generalized drawing primitive data record is invalid At least one active workstation is not able to generate the spectjied generalized drawing primitive At `least one active workstation is not able to generate the spectjied generalized drawing primitive under the current transformations and clipping rectangle

B.7 Segments
120 Spec$ed segment name is invalid

121 122 I23 124 125

Specified Specjfied Spec$ed Spec$ed Spectfied

segment segment segment segment segment

name is already in use does not exist does not exist on spectfied workstation does not exist on Workstation Independent Segment Storage is open
209
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Segments 126 Segment priority is outside the range [O,I]

Annex B

B.8 Input
I40 141 142 143 144 I45 146 147 148 I49 I50 151 152 153 1.54

Specified input device is not present on workstution Input device is not in REQUEST mode Input device is not in SAMPLE mode EVENT and SAMPLE input mode are not available at this level of GKS Spec@ed prompt and echo type is not supported on this workstation Echo urea is outside display space Contents of input data record are invalid input queue has over-owed Input queue has not over-owed since GKS was opened or the last invocation of INQUIRE QUEUE OVERFLOW input queue has ovetjlowed. but associated workstation has been closed No input value of the correct class is in the current event report Timeout is invalid Initial value is invalid Number of points in the initial stroke is greater than the bufler size Length of the initial string is greater than the buffer size

INPUT

B.9 Metafiles
160

161 162 163 164 16-F 166 167 168

Item' type is not allowed.for user items item length is invalid No item is left in GKS Metafile input Metafile item is invalid Item type is not a valid GKS item Content of item data record is invalid for the specjjied item type Maximum item data record length is invalid User item cunnot be interpreted Specified function is not supported in this level of' GKS

B.10 Escape 180 .Specifed escape .function is not supported 18t Spec$ed escape function identification is invalid 182 Contents of escape data record are invalid B. 11 Miscellaneous 200 Spec$ed error file is invalid B.12 System 300 Storage overjb~w has occurred in GKS 3OI Storage overjjOw has occurred in segment storage 302 Input/Output error has occurred while reading 303 Input/Output error has occurred while writing 304 InputfOutput error has occurred while sending data to a workstution 300 Input/Output error has occurred while receiving data ,from (I workstation 306 Input/Output error has occurred during program librurv management 307 ItlputiOllrtput error has occurred nhile reading workstation description table 36208Arithmetic error has occurred B.13 Reserved errors

Unused error numbers less than 2 000 are reserved for future standardization.
Error numbers 2 000-J 999 are reserved for language bindings.
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Annex 5 Error numbers greater than or equal to 4 000 are reserved for registration.
NOTE - Error numbers are registered in the the IS0 international Register of Graphical Items, which is maintained by the Registration Authority (see 4. I .2). When an error has been approved by ISO, the error number will be assigned by the Registration Authority.

Reserved errors

211

IS : 12369 - 3987 ISO 7942 - 1985

Annex C Interfaces

(This a*mex does not form an integral part of the standard, but provides additional information.)

C.l Ger era1
GKS is .rescribed in abstract terms, in order that it may be useful to applications written in a wide range of ?ro~a.?ming languages (host languages). Before it can be used by a particular application program written in a particular language, two further stages of specification are required:
a) the abstract functions and data types of GKS need to be expressed in terms of the constructs available in the host language; b) this set of language specific facilities then needs to be provided machine and operating system. using the facilities of a particular

C.2 Language binding
A GKS language binding is a document describing how GKS functions are accessed by programs written in a specific language. The following rules need to be observed when binding GKS to a host language. The object of a binding is to provide the functions and data types of GKS in a natural and efficient manner using the facilities of the host language. Rule Ll: All GKS functions, other than inquiry functions, need to appear atomic to the application program.

This rule forbids the binding from mapping single GKS functions into sequences of language functions called by the application program, except possibly for inquiry functions, which, for example, in certain language bindings may need to be called once for each element of a list. Rule L2: The language binding needs to specify, for each GKS abstract identifier acceptable to the language. function name, exactly one

The names used for GKS functions in the International Standard are merely tools for describing the semantics of the International Standard; they should be replaced by actual identifiers conforming to the restrictions of the host language. A one-to-one mapping from language functions to abstract functions is preferred. Rule L3: The language binding needs to specify, for each of the GKS data types, a corresponding data type acceptable- to the language, except where convenient for the host language, additional data types may be specified in terms of the GKS data types.

The data types used in the International Standard are merely tools for describing the semantics of the International Standard, they need to be replaced by actual data types conforming to the restrictions of the host language. Rule L4: The language binding needs to specify, for each GKS abstract function, how the corresponding language function is to be invoked, and the means whereby each of the abstract input parameters is transmitted to the language function and each of the abstract output parameters is received from the language function.

Where the host language allows, the abstract functions are mapped onto language functions or procedures. The parameters are typicaily transmitted via a parameter list. The items in such a list may either be, or be references to, items of the data types corresponding to the GKS data types, or aggregates of these types. Rule L5: The language binding needs to specify a set of identifiers, acceptable to the language, which may be used by an implementation for internal communication.

An implementation is normally unable to restrict its use of externally visible identifiers to those specified as a consequence of rules Ll to L4. Applications should, therefore, avoid using identifiers from the, set required by rule L5. The set may consist, for example, of all identifiers beginning with GKS. \
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C.3 Implementation A GKS implementation is a module or library of modules written for a specific programming language and conforming to a GKS language binding. The following rules need to be observed when implementing GKS. The objective is to provide all the functions of a particular level of GKS, and none of the functions of higher levels of GKS, in an efficient manner using the facilities available from the host machine and operating system. Rule 11: The documentation of a GKS implementation needs to include a list of all identifiers for procedures, functions, global data aggregates, and files that are visible either to an application program or to the underlying operating system.

Because this set of identifiers is, in general, a superset of the names specified by the language binding, programs transported to an implementation from other implementations of the same binding might have used names that clash. Documentation is required to enable potential clashes to be detected (see also rule LS). Rule 12: Implementations should not restrict an application program's use of any I/O facilities provided by the host language or operating system. However, implementations should prevent applications from bypassing GKS and accessing graphical resources directly.

An implementation needs to assume that it has exclusive control over the graphical resources it is managing. However, as few restrictions as possible should be placed upon the use of other resources. Rule 13: The documentation of an implementation needs to specify, for each of the implementation workstation dependencies, how the dependencies are resolved. and

Several details of the International Standard are deliberately not specified so as to provide implementors with sufficient freedom to adapt to particular computers and operating systems. These are indicated in the text by the words `implementation dependent'. Others are not specified to allow for adaptation to particular graphics devices. These are indicated in the text by the words `workstation dependent'. A list of all such details is given as annex D. The resolution of each of these details needs to be documented so that the behaviour of application programs may be predicted. Rule 14: The documentation of each workstation of an implementation needs to specify the correspondence between physical input devices and operator actions, and the logical input devices on that workstation (if any). \,

The correspondence between physical input devices and operator actions, and the logical input devices-on a workstation is static, and not under the control of the application program. These correspondences need to be documented. It is also desirable that workstation implementors provide means whereby these correspondences may be changed, perhaps during a GKS configuration phase. However, any such means lie outside the scope of the International Standard.
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Annex D

Allowable differences in GKS implementations
(This annex does not form an integral part of the standard, but provides additional information.)

D.l General
A number of details of GKS are deliberately not specified, so as to provide the freedom to adapt implementations to different environments and different requirements. In particular, GKS is described in abstract terms, so that it can be useful to application programs written in a wide range of programming languages. In a language binding, the abstract GKS functions are embedded in a language dependent layer, according to a number of rules. These rules are set out in annex C and are not considered further here. Other allowable differences fall into two categories: a) global differences; b) workstation dependent differences. The purpose of this annex is to itemize these allowable differences. The documentation accompanying a particular implementation needs to list, for each allowable difference, the specific choices made in that implementation.

,

D.2 Global differences
A number of differences are global in the sense of applying to an implementation particular workstation. These global differences are itemized below. a) Functional scope: 1) GKS level. b) Capacity: 1) number of available workstation types; 2) list of available workstation types; 3) maximum number of simultaneously open workstations; 4) maximum number of simultaneously active workstations; 5) maximum number of workstations associated with a segment; 6) maximum normalization transformation number; 7) number of simultaneously definable segments (per workstation): 8) maximum size of input queue; 9) number of fonts available; 10) number of GDP's; 11) number of ESCAPE functions. c) Miscellaneous: 1) initial setting of Associated Source Flags (ASFs); 2) EMERGENCY CLOSE GKS behaviout; 3) actions performed on parameters of inrisriry functiono if information is unavailable; 4) metafile format used by each workstation type of category MO; 5) font definitions (with,the restriction `ihat font numbers greater than 1 may be registered). as a whole rather than to a
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NOTES
I 2 Items in a) and b) I) IO b) 6) are held in the GKS As well as specifying `maximum size of input description table. and can be inquired by an applicaiion program. (including the relalive

Global differences

queue'.

the documentation

needs to specify

its interpretation

lengths of each item if necessary). 3 At different GKS levels, certain minimum capabilities are detined in 4.10.

D.3 Workstation dependent differences
This group of allowable differences provides for a range of workstations to be used in a GKS implementation. The major group of differences are listed as the workstation description table, specified in 6.6, which forms part of the GKS data structures. Entries in this table may be inquired by an application program. There are restrictions, however, on the values of some entries; at different GKS levels, certain minimal capabilities of a workstation are defined (see 4.10). In addition, a number of further workstation dependent differences are listed here: a) Control functions: 1) Realization of GKS functions: MESSAGE, ESCAPE; 2) Buffering of deferred actions in deferral modes BNIL, BNIG and ASTI. b) Output functions and attributes: 1) POLYLINE i) whether linetype is continuous or rest.arted, at the start of a polyline, at the start of a clipped piece of a polyline and at each vertex of a polyline; ii) graphical representation of available linetypes (with the restrictions t&at linetypes I to 4'need to be recognizable as solid, dashed, dotted and dashed-dotted, linetypes greater than 4 may be registered and linetypes less than 0 need to have similar appearance on all workstations on which they are available); iii) the shape of the ends of lines for certain values of the linewidth sea+ factor aspect; 2) POLYMARKER i) graphical representation of available marker types (with the restricti* that marker types 1 to 5 need to be recognizable as dot, plus sign, asterisk, circle and diagonal cross, marker types greater than 5 may be registered and marker types less than 0 need to have similar appearance on all workstations on which they are available); ii) clipping of markers, whose position is just inside a clipping bow; 3) TEXT i) clipping of STRING and CHAR precision text; ii) for STRING precision, how current settings of the text aspects are taken into account; iii) for CHAR precision, evaluation of the aspects character HEIGHT, and CHARACTER UP VECTOR; iv) the effect of control characters in the character string; 4) FILL AREA i) graphical representation of available hatch styles (with the restriction that hatch styles greater than 0 may be registered and hatch styles less than 0 need to have similar appearance on all workstations on which they are available); ii) whether patterns and hatching are affected by transformations; iii) linetype and linewidth for interior style HOLLOW; 5) CELL ARRAY expansion factor, CHARACTER
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i) whether CELL ARRAY is fully supported or sometimes simulated and, if the latter. the simulation (minimal action required is to draw the transformed boundaries of the cell rectangle, using implementation dependent colour, linetype and linewidth); 6) GDP i) realization of each GDP; 7) all primitives i) colour index used if an output primitive is displayed with a colour index that is not present in the colour table; ii) on monochrome workstations, algorithm for mapping (red, green, blue) colour values to intensity. A recommended algorithm is: intensity = 0.3 x red + 0.59 x green + 0.11 x blue and this intensity is mapped to the nearest available; iii) what is drawn when points are collinear or points or lines coincide (see 4.5.3). (All primitives except POLYMARKER.) 1 c) Segments: 1) picking segments of equal priority; 2) dioplay of overlapping segments of equal priority; 3) realization of highlighting. d) Input functions (see also annex C): 1) realization of logical input devices (for each logical input device, its measure and trigger need to be described in terms of the physical devices available on a workstation); 2) default prompt and echo type realization; 3) use of input data record for optional parameters. , e) Inquiry 1) values returned by INQUIRE TEXT EXTENT; 2) values returned by PIXEL inquiry functions; 3) answers returned by inquiry when the REALIZED flag is set.
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Annex E
Metafile structure

(This annex does not form an integral part of the standard, but provides additional information.)

E. 1 Metafiles
E.l.l

General

In clause 1, it states that GKS `includes functions for storage on and retrieval from an external graphics file'. This external file is called a graphics `metafile or metafile. GKS metafiles can be used for a variety of purposes (as stated in 4.9); a) transporting graphical information between systems; b) transporting graphical information c) transporting graphical information from one place to another; from one GKS application to another;

d) storing accompanying non-graphical information. These purposes cover different aims including picture capture, structured picture capture and session capture, the latter also being called audit trail. The graphical information needed for these aims corresponds to different types of metafile. For picture capture, some output-related functions (such as those that manipulate segments) may be recorded as the resulting set of primitives and their attributes. For structured picture capture or session capture, all functions that GKS sends to the workstation need to be recorded. The encoding mechanism used for writing the metafile may depend on the application example: e) encoding within the rules of IS0 2022 to enable network transfer; l) binary encoding to ease storage on a machine for later use on that machine or to minimize the processing requirement; g) clear text encoding to enable transfer between highly different computer architectures and easy editing. The specification of the format and content of a metafile is not part of GKS. GKS only specifies the interface to the metafile. An implementation of GKS may support any number of workstation types of category MI or MO. The user may.select the most appropriate of these depending on the application and environment. Two meWYes are outlined in E.l:2 and E.1.3. E.1.2 IS0 8632 Meta6Ie This metafile (IS0 8632) may be categorized as one which aims to provide a means of recording pictures using metafile elements compatible with Level Oa of GKS. It is suitable for picture capture but less suitable for session capture or structured picture capture, the latter not being possible. The metafile permits a variety of encoding schemes to be used from a single abstract metafile specification. The encodings that are included are: a) a character encoding based on IS0 2022 code extension procedures; b) a binary encoding based on IEEE (Draft 810 Task P754) floating point formats; c) a clear text encoding. Other standardized encodings may be added in time; private encodings based on the abstract structure and the rules of conformance given in the International Standard are also allowed. E.1.3 MetafiIe designed for GKS This metafile may be categorized as one which aims to provide a means of recording the exact sequence of function calls made to a @KS workstation. Its functional capability covers the entire range otr GKS output functions, from level 0 to level 2. It is suitable for picture capture, structured picture capture or session capture. It is particularly suitable for transporting graphical information from one GKS application to another and for applications where the individual graphics actions need to be replayed, with optional editing. 217 or environment, for
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Two encodings are specified for this metafile. They are: a) a clear text encoding; b) an unspecified binary format. This metafile is described in t.he following clauses.

E.2 File format and data format
The GKS metafile is built up as a sequence of logical data items. The file starts with a file header in fixed format which describes the origin of the metafile (author, installation), the format of the following items, and the number representation. The file ends with an end item indicating the logical end of the file. In between these two items the following information is recorded in the sense of an audit trail:
.

a) workstation control items and message items; b) output primitive items, describing elementary graphics objects; c) attribute information, butes; e) user items. The overall structure of the GKS metafile is as follows: FILE: file header item 1 . .. including output primitive attributes, segment attributes, and workstation attri-

d) segment items, describing the segment structure and dynamic segment manipulations;

ITEM:

item F-p_

item data retard-1

All data items except the tie header have an item header containing: f) the character string `GKSM' (optional) which is present to improve legibility of the file and to provide an error control facility; g) the item type identification item; number which indicates the kind of information that is contained in the

h) the length of the item data record. The lengths of these fields of the item header are implementation dependent and are specified in the file header. The content of the item data record is fully described for each item type later in this annex. The metafile contains characters, integer numbers, and real numbers marked (c), (i), (r) in the item description. Characters in the metafile are represented according to IS0 646 and IS0 2022. Numbers are represented according to IS0 6093 using format Fl for integers and format F2 for reals.
NOTE - Formats FI and F2 can be written and read via FORTRAN formats 1 and F respectively.

Real numbers describing coordinates and length units are stored as normalized device coordinates. The workstation transformation, if specified in the application program for a workstation writing a metafile of this format. is not performed but WORKSTATION WINDOW and WORKSTATION VIEWPORT are stored in data items for later use. Real numbers may be stored as integers. In this case transformation parameters are specified in the file header to allow proper transformation of integers into norzpalized device coordinates. For reasons of economy. 218 /' numbers can be stored using an internal binary format. As no lnternational
I

I/'
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Standard exists for binary number representation, this format limits the portability of the metafile. specification of such a binary number representation is outside the scope of this International Standard.

The

When exchanging metafiles between different installations, the physical structure of data sets on specific storage media should be standardised. Such a specification is outside the scope of this International Standard.

E.3 Generation of metafiles
Table 4 contains a list, by class, of all GKS functions which apply to workstations of category MO, and their effects on this GKSM. In the table, GKSM-OUT is a workstation identifier indicating a workstation writing a metafile of this format. The concepts of clipping rectangle and clipping indicator are encapsulated in one metafile item which specifies a clipping rectangle. This item is written to the metafile on activate workstation with the values (O,l,O,l), if the `clipping indicator' entry in the GKS state list is NOCLIP, or the clipping rectangle in the GKS state list, if the `clipping indicator' entry in the GKS state list is CLIP. If the clipping rectangle in the GKS state list is redefined when the `clipping indicator' entry in the GKS state list is CLIP, a further clipping rectangle item is written. If the `clipping indicator' entry in the GKS state list is changed to NOCLIP, a clipping rectangle item (O,l,O,l) is written. If the clipping indicator' entry in the GKS state list is changed to CLIP, an item containing the clipping rectangle in the GKS state list is written. This is analogous to the handling of clipping in segments (see 4.7.6).

'
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Table 4 - GKS functions and their effect on GKSM output workstations GKS functions which apply to workstations of category MO Control functions OPEN WORKSTATION (GKSM-OUT,...) CLOSE WORKSTATION (GKSM-OUT) ACTIVATE WORKSTATION (GKSM-OUT) GKSM item created or effect

DEACTIVATE WORKSTATION (GKSM-OU'I CLEAR WORKSTATION (GKSM-OUT,...) REDRAW ALL SEGMENTS ON WORKSTATION (GKSM-OUT) UPDATE WORKSTATION (GKSM-OUT,...) SET DEFERRAL STATE (GKSM-OUT,..) MESSAGE (GKSM-OUT,. . .) ESCAPE output primitives POLYLINE POLYMARKER TEXT FILL AREA CELL ARRAY GENERALIZED DRAWING PRIMITIVE Output attributes SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET POLYLINE INDEX LINETYFE LINEWIDTH SCALE FACTOR POLYLINE COLOUR INDEX POLYMARKER INDEX MARKER TYPE MARKER SIZE SCALE FACTOR POLYMARKER COLOUR INDEX TEXT IYDEX TEXT FONT AND PRECISION CHARACTER EXPANSION FACTOR CHARACTER SPACING TEXT COLOUR INDEX CHARACTER HEIGHT CHARACTER UP VECTOR TEXT PATH TEXT ALIGNMENT FILL AREA INDEX FILL AREA INTERIOR STYLE FILL AREA STYLE INDEX FILL AREA COLOUR INDEX PATTERN SIZE PATTERN REFERENCE POINT ASPECT SOURCE FLAGS PICK IDENTIFIER

- (file header) 1 (CONDITIONAL) 0 (end item) (61, 21-44) ensure attributes current; enable output disable output 1 2 3 4 5 (message) 6

11 12 13 14 15 16

21 22 23 24 25 26 27 28 29 30 31 32 33 34 34 35 36 37 38 j 39 j 40 ! 41
42

43 44
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SET SET SET SET SET SET

POLYLINE REPRESENTATION (GKSM-OUT,...) POLYMARKER REPRESENTATION (GKSM-OUT,...) TEXT REPRESENTATION (GKSM-OUT,...) FILL AREA REPRESENTATION (GKSM-OUT,...) PATTERN REPRESENTATION (GKSM-OUT,...) COLOUR REPRESENTATION (GKSM-OUT,...)
functions

51 52 53 54 55 56 c
/ 34,41,42

Transformation

SET WINDOW of current normalization transformation (see note 2) SET VIEWPORT of current normalization transformation (see notes 1 and 2) SELECT NORMALIZATION TRANSFORMATION (see notes 1 and 2) SET CLIPPING INDICATOR (see note 1) SET WORKSTATION WINDOW (GKSM-OUT,...) SET WORKSTATION VIEWPORT (GKSM-OUT,...)
Segment functions

61,34,41,42

61,34,41,42 61 71 72

-

t CREATE SEGMENT CLOSE SEGMENT RENAME SEGMENT DELETE SEGMENT DELETE SEGMENT FROM WORKSTATION (GKSM-OUT,...) ASSOCIATE SEGMENT WITH WORKSTATION (GKSM-OUT,...) COPY SEGMENT TO WORKSTATION (GKSM-OUT,...) INSERT SEGMENT
Segment attributes

81 52 83 84 84 81, (91-95), (21-44), (21~44),(11-16),(61)

SET SET SET SET SET

SEGMENT TRANSFORMATION VISIBILITY HIGHLIGHTING SEGMENT PRIORITY DETECTABILITY

Metafile functions

IWRITE
L.

ITEM TO GKSM

NOTES I 2 Item 61 (CLIPPING When the current RECTANGLE) normalization is described more fully in clause E.3. transformation is altered, items corresponding to attributes containing coordinate information are

sent (items 34. 41 and 42).
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E.4 Interpretation
E.4.1 General

The interpretation of metafiles in GKS is described in 4.9. The effects of INTERPRET metafile item are described in E.4.2 to E.4.8. Items are grouped by class as in table 4.
E-4.2 Control items

ITEM for all types of

Interpretation
Ei4.j

of items in this class is described under the definitions of each item in clause ES.

Output primitives

Interpretation of items in this class generates output corresponding to the primitive functions, except that coordinates of points are expressed in NDC. Output primitives have bound to them thcappropriate primitive attributes from the GKS state list.
E.4.4 Output primitive attributes

* Interpretation

of items in this class sets entries in the GKS state list. The geometric attribute information, which is expressed in NDC, is transformed by the inverse of the currently selected normalization transformation before being used to set these entries. Interpretation of the character vectors item causes the two vectors to be thus transformed and the entries in the GKS state list to be set as follows. The `current character height' entry is set to the length of the transformed character height vector and the `current character up vector' entry is set :o a vector of arbitrary length, parallel to the transformed character height vector. The `current chaiacter width' and `current character base vector' are similarly set using the transformed character width vector. E.4.5 Workstation
attributes

Interpretation of items in this class has the same effect as invocation of the corresponding shown in table 4. The GKS functions are performed on all active workstations.
E.4.6 Transformations

GKS functions

Interpretation of a clipping rectangle item sets the `clipping rectangle' entry in the GKS state list and also sets the `clipping indicator' entry in the GKS state list to CLIP. Inteipretation of other items in this class (WO%KSTATIbN WINDOW snd WORKSTATION VIEWPORT) causes the invocation of the corresponding GKS functions on all active workstations.
E.4.7 Segment manipulation

Interpretation of items in this class has the same effect as invocation of the corresponding shown in table 4. (Item 84 causes an invocation of DELETE SEGMENT.)
E.4.8 Segment attributes

GKS functions

Interpretation of items in this class has the same effect as invocation of the corresponding shown in table 4.
E.5

GKS functions

Control items
.

FILE HEADER

All fields in the file header item have fixed length. dS0 6093.

Numbers are formatted

according to Format .

Fl of
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General information: GKSM N D V 4 bytes 40 bytes 8 bytes 2 bytes containing string `GKSM' containing name of author/installation date (year/month/day, for example 79/ 12/3 1) version number: the metafile described here has version number 1

Specification of field length H T L I 2 bytes 2 bytes 2 bytes 2 bytes integer specifying how many bytes of the string `GKSM' are repeated at the beginning of each record. Possible values: 0, 1, 2, 3, 4. length of item type indicator field length of item data record length indicator field length of field for each integer in the item data record [applies to all data marked (i) in the item description] length of field for each real in the item data record [applies to all data marked (r) in the item description]

R

2 bytes

Specification of number representation F 2 bytes Possible values: 1, 2. This applies to all data in the items marked (i) or (r) and to item type and item data record length: 1: all numbers are formatted according to IS0 (593 2: all numbers (except in the file header) are stored in an internal binary format Possible values: 1, 2. This is the number representation for data marked (r): 1 = real, 2 = integer integer equivalent to 0.0, if RI = 2 integer equivalent to 1.O, if RI = 2

RI

2 bytes

ZERO ONE

11 bytes 11 bytes

After the file header, which is in fixed format, all values in the followirrg items are in the format de&red by the file header. For the following description, the setting H-4; T-3; F=l

is assumed. In addition to formats (c), (i) and (r), which are already described, (p) denotes a point represented by a pair of real numbers (2r). The notation allows the sin,gle letter to be preceded by an expression, indicating the number of values of that type. END ITEM j `GKSM 0' j L 1 Sets condition. for the error `_Noitem is left in GKS Metafile input'

Last item of every GKS Metafile.
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CLEAR WORKSTATION ;.;c_KiG -i; jL-[ -cl on all active workstations

Requests CLEAR WORKSTATION C(i): clearing control flag (0 = CONDITIONAL,

1 = ALWAYS)

REDRAW ALL SEGMENTS ON WORKSTATION ---? [ `GKSM 2' jL/ Requests REDRAW ALL SEGMENTS UPDATE WORKS,TATION [`GKSM 39 1 L j R] on all active workstations ON WORKSTATION on all active workstations

Requests UPDATE WORKSTATION R(i):

update regeneration flag (0 = PERFORM, 1 = POSTPONE) STATE

DEFERRAL i `GKSM ___-D(i): R(i):

4'. j L I- D / R / STATE on all active workstations

Requests SET DEFERRAL

deferral mode (0 = ASAP, 1 = BNIG, 2 = BNIL, 3 = ASTI) implicit regeneration mode (0 = ALLOWED, 1 = SUPPRESSED)

MESSAGE
1 `GKSM

5' 1 L j N 1 T /

Requests MESSAGE on all active wcxkstations N(i): i(Nc): ESCAPE
1 `GKSM

number of characters in stri ng string with N characters

6' 1 L 1 FI j L j h4 1 I-J-$

Requests ESCAPE FI(i): L(i): M(i): I(Li): R(Mr): function identifier length of integer data in dat;i record length of real data in dafra record integer data real data
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E.6 Items for output primitives
POLY LINE [`GKStiTL N(i): P(Np): 1N 1P ]

number of points of the polyline list of points

POLYMARKER ~GKsM~~/ N(i): P(Np): TEXT p GKSM 13' 1 L 1 P j N 1 T`/ P(p): N(i): T(Nc): starting point of character string number of characters in string T string with N characters from the set of IS0 646 number of points list of points
* ,

FILL AREA
1 `GKSM 14' \ L 1 N 1 P 1

1 N(i): P(Np):

number of points list of points

CELL ARRAY ) ~GKSM 15' 1 L ] P ) Q 1 R P(p),Q(p),R(p):

1 N ) M 1 a-]

coordinates of corner points of pixel array [p and Q are the images of the points P and Q specified in the function CELL ARRAY and R is the image of the corner point associated with the (DX,l) element by the function CELL ARRAY]

N(i): M(i):

number of columns in array number of rows in array

CT(MNi): array of colour indices stored row by row GENERALIZED DRAWING PRIMITIVE

( `GKSM 16' 1 L 1 GI 1 N 1 LI 1 LR ( P ( I 1 R_i GI(i): N(i): LI(i): LR(i): P(Np): I(LIi): R(LRr): GDP identifier number of points length of integer data in data record length of real data in data record list of points integer data real data
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E.7 Items for output primitive attributes
POLYLINE INDEX (`GKSM--LI--,-L~~~~
! 1 --

I(i):

polyline index

LINETYPE

LINEWIDTH p?%S%23' LW(r):

SCALE FACTOR
/ L(Lw]

linewidth scale factor COLOUR INDEX

POLYLINE ~~KSM CI(i):

24' 1 L 1 CI ] polyline colour index INDEX

POLYMARKER J;GKSM25'1LJIj I(i):

polymarker index

MARKER TYPE r;GxsMqLTq MT(i): marker type

MARKER SIZE SCALE FACTOR `GKSM 27' 1 L / MS 1 c _____ MS(r): marker size scale factor COLOUR INDEX T-cIl

POLYMARKER F-p 1 `GKSM 28'i-L L___CI(i):

polymarker colour index

TEXT INDEX -__[%KsM 29' l-~ L__ ._ _._-__-A. I(i): text index

/ CJ
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TEXT FONT AND PRECISION

1`GKSM 30'
F(i): P(i):

1 L 1 F 1P j

text font text precision (0 = STRING,
1 = CHAR, 2 = STROKE)

CHARACTER

EXPANSION

FACTOR

[~GKSM 319 1 L 1 CEF ) CEF(r): character expansion factor SPACING
1 L 1 CS 1

CHARACTER [`GKSM32' CS(r):

character spacing

TEXT COLOUR INDEX [`GKSM CI(i): 33' 1 L ( CI 1 text co1 jut index VECTORS
1 L 1 CH 1 CW]

CHARACTER L'GKSM

CH(2r): character height vector CW(2r): character width vector
NOTE - These vectors are the height and width vectors described in 4.4.5

TEXT PATH
1 `GKSM 35' 1 L 1 P )

P(i):

text path (0 = RIGHT,

I= LEFT, 2 = UP, 3 = DOWN)

TEXT ALIGNMENT
1 `GKSM 36' ( L 1 H 1 V 1

H(i): V(i)

horizontal character alignment (0 = NORMAL, 1 = LEFT, 2 = CENTRE, 3 = RIGHT) vertical character alignment (0 = NORMAL, 1 = TOP, 2 = CAP, 3 = HALF, 4 = BASE, 5 = BOTTOM)

FILL AREA INDEX j'GKSM~q?-j I(i): fill area index
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3 = HATCH)

FILL AREA STYLE INDEX
[ `GKSM- 39' 1 L- 1 SI 1

SI(i):

fill area style index

FILL AREA COLOUR INDEX
1 `GKSM 40' 1 L 1 CI 1

CI(i):

fll area colour index

PATTERN VECTORS
[ `GKSM 41' 1 L 1 PW 1 PH 1

PW(2r): pattern width vector PH(2r): pattern height vector REFERENCE POINT

PATTERN

[ `GKSM 42' 1 L 1 P 1

P(p):

reference point

ASPECT SOURCE FLAGS
1 `GKSM 43' 1 L 1 F )

F( 13i):

aspect source flags (0 = BUNDLED, 1 = INDIVIDUAL)

'

PICK IDENTIFIER
[ `GKSM 44' j L [ P 1

P(i):

pick identifier

E.8 Items for workstation attributes POLYLINE REPRESENTATION

1 `GKSM 51' 1 L ) I 1 LT 1 LW j Cz, I(i): LT(i): LW(r): . CI(i): polyline index linetype number linewidth scale factor polyline colour index

Annex
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POLYMARKER REPRESENTATION -r;-6KSM 52' ( L 1 I 1 MT 1 MS 1 CI 1 polymarker index I(i): MT(i): marker type MS(r): marker size scale factor polymarker colour index CI(i): TEXT REPRESENTATION [`GKSM53' 1 L 1 II I(i): F(i): P(i): F 1 P 1 CEF 1 CS 1 CI]

text index text font text pee&ion (0 = STRING, 1 = CHAR, 2 - STRQKE) character expansion factor CEF(r): CS(r): character spacing CI(i): text colou index FILL AREA REPRESENTATION
[

`GKSM 54' 1 L 1 I 1 S 1 SI 1 CI 1 fill area index fill area interior style (0 = HOLLOW, 1 = SOLID, 2 -PATTERN, 3 -HATCH) fill area style index fill area colour index

I(i): S(i): SI(i): CI(i):

PATTERN REPRESENTATIdN
[

`GKSM 55' 1 L 1 I 1 M 1 M 1 CT 1

I(i): pattern index N(i): number of columns in array M(i): number of rows in array CT(MNi):table of colour indices stored row by row COLOUR REPRESENTATION
1 `GKSM

56' 1 L 1 CI 1 RGB ]

CI(i): colour index RGB(3r): red, green, blue intensities
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E.9 Items for transformations CLIPPING p@tivT-] C(4r): limits of clipping rectangle (XMIN, XMAX, YMIN, YMAX) WINDOW RECTANGLE

WORKSTATION jFSM_71'q-Jq __ W(4r):

limits of workstation window (XMIN, XMAX, YMIN, YMAX) VIEWPORT

WORKSTATION r;cKsM72'-L;i L__ _._ V(4r):

limits of workstation viewport (XMIN, XMAX, YMIN, YMAX)

E.10 Items for segment manipulation CREATE SEGMENT _81'L
S(i): (s/

segment name

CLOSE SEGMENT /`GKSM82'J Indicates end of segment RENAME SEGMENT --_-. 1 `GKSM 83'L~l~~j SO(i): SN(i): old segment name new segment name

DELETE SEGMENT

S(i):

segment name

E. 11 Items for segment attributes SET SEGMENT TRANSFORMATION r;GKmr .__-.__ S(i): M(6r):
.---

L

1 s -ij

_

segment name transformation matrix MII,MI~.MI~,M~I.M~~,M~~
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SET VISIBILITY 1 `GKSM 92' 1 L 1 <p-j ___S(i): V(i): segment name visibility (0 = VISIBLE, 1 = INVISIBLE)

SET HIGHLIGHTING
j `GKSM 93' 1 L 1 S 1 H ]

S(i): H(i):

segment name highlighting (0 = NORMAL, 1 = HIGHLIGHTED)

SET SEGMENT

PRIORITY

I'GKSM94' 1 L 1 S 1 P]
S(i): P(r): segment name segment priority

SET DETECTABILITY
[ `GKSM 95' 1 L

1S 1D 1

S(i): D(i):

segment name detectability (0 = UNDETECTABLE,
1 = DETECTABLE)

E.12 User items
USER ITEM [`GKSMXXX' > 100 D: user data (L bytes)
/ L 1 D]
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Sample programs

(This annex does not form an integral part of the standard, but provides additional information.) The following sample programs, using Pascal-like syntax, illustrate the use of GKS functions.
Example 1

A batch job creates output primitives and stores them permanently on a metafile.
(Dethitions and declarations omitted) OPEN GKS (ERRFILE, MEM); OPEN WORKSTATION (GKSM-OUT, FILEI, GKSM OUTPUT); ACTIVATE WORKSTATION (GKSM-O!JT);

{metafile Output} {output on met&e)

application program acquires parameter values for GKS functions (including segment functions) and calls them, for example: POLYLINE (##points, array of points); FILL AREA (#points, array of points); DEACTIVATE WORKSTATION (GKSM-OUT); CLOSE WORKSTATION (GKSM-OUT); CLOSE.GKS;

{metafile released}

Example 2

A batch job reads a metafile and creates output on a plotter.
{Definitions and declarations omitted} OPEN GKS (ERRFILE, MEM); OPEN WORKSTATION (GKSM-IN, FILEl, GKSM_INPUT); OPEN WORKSTATION (PLOTTER, DDPLT, FLAT-BED-PLOTTER); ACTIVATE WORKSTATION (PLOTTER); REPEAT GET ITEM TYPE FROM GKSM (GKSM-IN, ITEM-TYPE, ITEM-LENGTH); READ ITEM FROM GKSM (GKSM-IN, ARRAY-LENGTH, ARRAY); INTERPRET ITEM (ITEM-TYPE, ITEM-LENGTH, ARRAY); UNTIL ITEM-TYPE = EOFTYPE; DEACTIVATE WORKSTATION (PLOTTER); CLOSE WORKSTATION (PLOTTER); CLOSE WORKSTATION (GKSM-IN); CLOSE GKS; (no more output on plotter} (metafile released]

{metafile inpul} {plotter workstation} {output on plotter)

Example 3

An interactive job reads segments from long term storage (the GKSM) and displays them on the display SW face. It allows the operator to pick one of the segments, place it on the screen, transform it and insert it into the picture he builds up. It lets him do this until he hits an end of picture key. The final picture is then output on a plotter. The segments may be, for exaznple, flowchart symbols. the screen and are, &en used to .build the flowchart. They appear on the top or bottom or at the side of

(Definitians ad&declaradons.obtted} OPEN GKS mRAhLEi. MEMk OPEN W6RKSTATION (DI#LAY. DDDIS, REFRESHVECTORDISPLAY): OPBM WORKSTATION (PLOTTER. DDPLT. DRUMPLOTTER); OPEN WORKST.(\TION (GKSM-IN. FILEI. GKSM INPUT,; OPEN WORKSTATION (SEGSTORE. DDSEG. WI.%):

{display workstation) (plotter workstation} 9 {metafile inpul} {Workstation Independent Segmenl Storage)
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{The contentw of the metafile are displayed on the display} {Segments, if present, are stored on Workstation Independent Segment Storage) {as well as on the display workstation) {output on display) ACTIVATE WORKSTATION (DISPLAYi; (output on Workstation Independent Segment Storage) ACTIVATE WORKSTATION (SEGSTORE); {reading the GKSM) REPEAT GET ITEM TYPE FROM C;KSM [GKSM-IT'& ITEM-TYPE. ITEM-L.ENGTH); READ ITEM FROM GKSM (GKSM-IN, ARRAY-LENGTH, AR.RAY). INTERPRET ITEM (ITEM-TYPE, ITEM-LENGTH, ARRAY); UNTIL ITEM-TYBE = EOFTYPE; (metafile released) CLOSE WORKSTATION (GKSM-IN); DEACTIVATE WORKSTATION (SEGSTORE); {no more output on Workstation Independent Segment Storage) {By now the picture contained in the metafile is visible on the display. The segmenls contained in these data can be used for creating a new picture which will be output on a plott.er}
REPEAT

' SET PICK MODE (DISPLAY, I, EVENT, ECHO);
SET LOCATOR MODE (DISPLAY, 1, EVENT, ECHO); FOR I:=lTO BEGIN 2DG

{A segment is identified and provided with a reference point} {allow pick event input) {allow locator event input)

{read one pick and one locator event in arbitrary sequence) {standard working day) TIMEOUT = 8 HOURS; (wait for pick and locator input) AWAIT EVENT (TIMEOUT, WORKSTATION, CLASS, DEVNO): .IF (CLASS = PICKCLASS) THEN BEGIN (SEGNAME received) GET PICK (STATUS, SEGNAME, PICKIDENTIFIER); SET PICK MODE (DISPLAY, I, REQUEST, ECHO);
END ELSE {segment ref. point POINTI received) BEGIN

GET LOCATOR (TRANS-NUMBERI, POINTI); SET LOCATOR MODE (DISPLAY, I, REQUEST, ECHO): END; END ; SELECT NORMALIZATION TRANSFORMATION (TRANS-NUMBER1 j; (Subsequent points are expected to be in viewport of normalization transformation TRANS-NUMBERI. This would be zero, since no transformations have been set up explicitly} INITIALISE VALUATOR (DISPLAY, 1, I, I, (0.95, l.O), (0.95, 1.0). (0, IO)); {valuator I has initial value I, range [O,lO]and echo area in top right) INITIALKSE VALUATOR (DISPLAY, 2, 0, I, (0.90,0.95), (0.95.1 .O), (0,3.14)); (valuator 2 has initial value 0, range (0,3.14] and echo area next to valuator I} INITIALISE LOCATOR (DISPLAY, 1, TRANS-NUMBERI, POINTI. 2, (0.0.1.0). (0.0.1 .O), NULL); {locator 1 has initial value = segment ref. point and crosshairs echo) SET VALUATOR MODE (DISPLAY, I, SAMPLE, ECHO); (allow valuator 1 sampk input) SET VALUATOR MODE (DISPLAY, 2, SAMPLE, ECHO); {allow valuator 2 sampk input} SET LOCATOR MODE (DISPLAY, 1, SAMPLE, ECHO); {allow locator sampk input} SET CHOICE MODE (DISPLAY, I, EVENT, ECHO); {allow choice event input) {for indicating end of transformation or end of picture] {Transforming the segment SEGNAME) EVALUATE TRANSFORMATION MATRIX ((O,O),(O,O),0, (1,I), WC, MATRIX); (initial& transformation matrix)
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REPEAT
{scale factor} SAMPLE VALUATOR (DISPLAY, 1, SCALE} {rotation angle) SAMPLE VALUATOR (DISPLAY, 2, ANGLE); {target point} SAMPLE LOCATOR (DISPLAY, 1, TRANS-NUMBER2, P01NT2} IF TRANS-NUMBERl/ =TRANS-NUMBER2 THEN GOTO ENDLOOP; ACCUMULATE TRANSFORMATION MATRIX (MATRIX, POINT1, {accumulate transformation matrix} WC, MATACk POINT2-POINTI . ANGLE, (SCALE,SCALE), SET SEGMENT TRANSFORMATION (SEGNAME, MATAC); {segment SEGNAME is scaled by SCALE in x and y direction,} {rotated by ANGLE (both relative to POINTI), and finally) {shifted from POINT I to POINT2} TIMEOUT := O; AWAIT EVENT (TIMEOUT, UNTIL CLASS = CHOICECLASS;

Annex F

WORKSTATION,

CLASS.

DEVNO); {end of segment transformation

{choice kput

present?}

if choice input given}

ENDLOOP: SET VALUATOR MODE (DISPLAY, 1. REQUEST, ECHO} SET VALUATOR MODE (DISPLAY, 2, REQUEST, ECHO} SET LOCATOR MODE (DISPLAY, 1, REQUEST, ECHOi {Output transformed segment on plotter and display) COPY SEGMENT TO WORKSTATION (PLOTTER, SEGNAME} GET CHOICE (CHOICE-STATUS, ALTERNATIVE); SET CHOICE MODE (DISPLAY, 1, REQUEST, ECHO); 2; UNTIL CHOICE-STATUS = OK AND ALTERNATIVE= DEACTIVATE WORKSTATION (DISPLAYk CLOSE WORKSTATION (DISPLAY); CLOSE WORKSTATION (SEGSTOREk CLOSE GKS;

(no more valuator 1 sample input) {no more valuator 2 sample input) {no more locator sample input)

(no more choice input allowed) {ALTERNATIVE =2 indicates end of picture)

Example 4 A polygon is generated on a plotter.

at an interactive

workstation,

it is modified

interactively,

and a hardcopy

is produced

{Definitions and deckdralions omitted) OPEN GKS (ERRFILE, MEML OPEN WORKSTATION (DISPLAY, DDDIS, 3k ACTIVATE WORKSTATION (DISPLAYk OPEN WORKSTATION (SEG$TORE, DDSEG, WISS); ACTIVATE WORKSTATION (SEGSTORE): {set normalization transforrnatiou) SET WINDOW (1, WIN DOWBOUNDS~ SET WE WPORT (1, VIEWPORTBOUNDS~ SET VI EWPOftT INPUT PR1ORITY (i, O. HIGHER); {Construction of segment POLYGON} CREATE SEGMENT.(PGLYGONX SET POLYLINE INDEX (3); NEXT:= 1: REQUEST LOCATOR (DISPLAY. 1. STATUS, TRANSI . Ml]k SELECT NORMALIZATION TRANSFORMATION (TRANSlk

REPEAT
NEXT : = NEXT + i; REQUEST LOCATOR (DISPLAY, 1. STATUS, UNTIL STATUS = NONE OR TRANS/ = TRANSI ; PINEXTl : = P[l]; POLYLINE (NEXT. P): CLOSE SEGMENT; TRANS. p(NEXTlk
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{Now omn and activate ~btter workstation} OpEN WO'RKS_fATION(pLoTfER,DDpLOT, FLATBEDPLOmERk ACTIVATE WORKSTATION (PLOTTER]

Apex F

up a coordinate system} {Sei SET WINDOW (1, WINDOWLIMITS); SELECT NORMALIZATION TRANSFORMATION
{Command processing}

(1}

EVALUATE TRANSFORMATION MATRIX ((0,0), (o.o)> o.(1,1). wc> MATRIX} REPEAT READ (Symbol type, (XPOS,YPOS), ANGLE> CASE Symbol type OF
transistor

ACCUMULATE TRANSFORMATION ANGLEL (1,1), WC, MATAQ, INSERT SEGMENT (transistor-aegmenh

MATRIX (MATRIX,(0,0), (XPOS,YPOS), MATACk

resistor
ACCUMULATE TRANSFORMATION MATRIX (MATRIX (0,0), (XPOS,YPOS), ANGLE, (1,1), WC, MATAQ INSERT SEGMENT (reaiator-segmen~ MATAQ, corrncctiim: BEGIN {read in parameter from non-graphic tile} READ (XPOSl, YPOSl~ POLYLINE (2, (XPOS,YPOSJ@OSl, YPOSl)~
END etc.

ENDCASE ; UNTIL end of input file DEACTIVATE WORKSTATION (PLOITER~ CLOSE WORKSTATION (PLOTTER} CLOSE WORKSTATION (GKSM-1~,
CLOSE WORKSTATION CLOSE GK~ (SEGSTORE);

The whole picture is displayed on the right side of the screen while on the left side it is possible to display a sub-picture at greater magnification. Updates to the picture can be made in either drawing area with the left hand picture being used for detailed drawing. A LOCATOR-position defines which area is being used for inputting data as well as the data value itself.

Exarn#e 6 A picture is being composed from podtions input by a LOCATOR.

To redefine the display in the left hand window, a LOCATOR input is required in a command area, containing NEW VIEW, at the bottom -of the display area. The next two LOCATOR inputs define the lower left and upper right of the sub-picture to be displayed on the left region. To cause a move to a new sequence of connected lines, a LOCATOR input is required in another command area, containing GAP, also at the bottom of the dkplay area. The NONE status on REQUEST is always used to terminate the series of iriteractions.
{Definiticms and d~larations omitted}

OPEN GKS (ERRFILE, MEM); OPEN WORKSTATION (FIRST, IOC,DISPLAY~ ACTIVATE WORKSTATION (FIRST);

SET WINDOW (I, o,m, o,ioo); SET VIEWPORT (1 .0.55,0 .95,0.4. 0.8); SET WINDOW (2, O,100,0, 100): SET VIEWPORT (2, 0.05.0.45,0.4, 0.8); SET WINDOW (3, O,8,0. 1); SET VIEWPORT (3. 0.1.0.9,0.05, 0.15): SET WINDOW (4. O,8.0, Ik 0.25): SET VIEWPORT (4. 0.1,0.9.0.15. SET VIEWPORT INPUT PRIORITY (1. O.HIGHER):

{whole picture} {for sub-picture: initially whole picture}

236

I

